Mercurial > vim
annotate src/INSTALLpc.txt @ 20743:a672feb8fc4f v8.2.0924
patch 8.2.0924: cannot save and restore a register properly
Commit: https://github.com/vim/vim/commit/bb861e293e0170455184079fa537278754b07911
Author: Bram Moolenaar <Bram@vim.org>
Date: Sun Jun 7 18:16:36 2020 +0200
patch 8.2.0924: cannot save and restore a register properly
Problem: Cannot save and restore a register properly.
Solution: Add getreginfo() and make setreg() accept a dictionary. (Andy
Massimino, closes #3370)
author | Bram Moolenaar <Bram@vim.org> |
---|---|
date | Sun, 07 Jun 2020 18:30:03 +0200 |
parents | 63beef1ca62c |
children | a9292e0a7157 |
rev | line source |
---|---|
7 | 1 INSTALLpc.txt - Installation of Vim on PC |
2 | |
3 This file contains instructions for compiling Vim. If you already have an | |
4 executable version of Vim, you don't need this. | |
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 | 9 |
10 The file "feature.h" can be edited to match your preferences. You can skip | |
11 this, then you will get the default behavior as is documented, which should | |
12 be fine for most people. | |
13 | |
8960
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
14 This document assumes that you are building Vim for Win32 or later (Windows |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
15 XP/2003/Vista/7/8/10). There are also instructions for pre-XP systems, but |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
16 they might no longer work. |
714 | 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 | 22 |
23 Contents: | |
714 | 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 | 36 13. Building with DirectX (DirectWrite) support |
37 14. Windows 3.1 | |
38 15. MS-DOS | |
714 | 39 |
19116 | 40 16. Installing after building from sources |
2951 | 41 |
42 | |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
43 The currently recommended way (that means it has been verified to work) is |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
44 using the "Visual Studio Community 2015" installation. This includes the SDK |
12781
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
45 needed to target Windows XP. But not older Windows versions (95, 98), see |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
46 "OLDER VERSIONS" below for that. |
714 | 47 |
48 | |
49 1. Microsoft Visual C++ | |
50 ======================= | |
51 | |
12600
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
52 We do not provide download links, since Microsoft keeps changing them. You |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
53 can search for "Visual Studio Community 2015", for example. You will need to |
12600
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
54 create a Microsoft account (it's free). |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
55 |
12781
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
56 When installing "Visual Studio Community 2015 with Update 3" make sure to |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
57 select "custom" and check "Windows XP Support for C++" and all checkboxes |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
58 under "Universal Windows App Development Tools" |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
59 |
12600
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
60 |
714 | 61 Visual Studio |
62 ------------- | |
63 | |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
64 Building with Visual Studio (VS2010, VS2012, VS2013, VS2015, VS2017 and VS2019) |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
65 is straightforward. |
3847 | 66 |
714 | 67 To build Vim from the command line with MSVC, use Make_mvc.mak. |
68 Visual Studio installed a batch file called vcvars32.bat, which you must | |
69 run to set up paths for nmake and MSVC. | |
70 | |
856 | 71 nmake -f Make_mvc.mak console Win32 SDK or Microsoft Visual C++ |
72 nmake -f Make_mvc.mak GUI=yes GUI Microsoft Visual C++ | |
73 nmake -f Make_mvc.mak OLE=yes OLE Microsoft Visual C++ | |
714 | 74 nmake -f Make_mvc.mak PERL=C:\Perl PYTHON=C:\Python etc. |
856 | 75 Perl, Python, etc. |
714 | 76 |
77 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
|
78 debug support. |
714 | 79 |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
80 For compiling gVim with IME support on far-east Windows, add IME=yes |
714 | 81 to the parameters you pass to Make_mvc.mak. |
82 | |
83 See the specific files for comments and options. | |
84 | |
85 These files have been supplied by George V. Reilly, Ben Singer, Ken Scott and | |
86 Ron Aaron; they have been tested. | |
87 | |
88 | |
8960
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
89 Visual C++ 2010 Express Edition *msvc-2010-express* |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
90 ------------------------------- |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
91 |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
92 Visual C++ 2010 Express Edition can be downloaded for free from: |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
93 http://www.microsoft.com/express/vc/Default.aspx |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
94 This includes the IDE and the debugger. |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
95 |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
96 To set the environment execute the msvc2010.bat script. You can then build |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
97 Vim with Make_mvc.mak. |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
98 |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
99 |
12600
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
100 Targeting Windows XP with MSVC 2012 and later *new-msvc-windows-xp* |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
101 --------------------------------------------- |
8960
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
102 |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
103 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
|
104 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
|
105 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
|
106 follows: |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
107 LINK ... /subsystem:console,5.01 |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
108 |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
109 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
|
110 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
|
111 2012 under 64-bit Windows): |
8960
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
112 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
|
113 set INCLUDE=%WinSdk71%\Include;%INCLUDE% |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
114 set LIB=%WinSdk71%\Lib;%LIB% |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
115 set CL=/D_USING_V110_SDK71_ |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
116 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
|
117 |
12600
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
118 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
|
119 LIB and SUBSYSTEM_VER: |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
120 ... |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
121 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
|
122 ... |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
123 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
|
124 |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
125 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
|
126 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
|
127 options: |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
128 msvc2015 |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
129 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
|
130 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
|
131 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
|
132 Express edition. |
8eb8200a55b2
patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents:
14222
diff
changeset
|
133 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
|
134 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
|
135 msvc2015 x64 |
12600
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
136 |
8960
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
137 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
|
138 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
|
139 |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
140 VC 2019 dropped support for targeting Windows XP. If you want a binary that |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
141 targeting Windows XP, use VC 2017 or earlier. |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
142 |
8960
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
143 |
16229
081522b02c2d
patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents:
15408
diff
changeset
|
144 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
|
145 ------------------------------------------ |
081522b02c2d
patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents:
15408
diff
changeset
|
146 |
081522b02c2d
patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents:
15408
diff
changeset
|
147 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
|
148 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
|
149 |
081522b02c2d
patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents:
15408
diff
changeset
|
150 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
|
151 |
081522b02c2d
patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents:
15408
diff
changeset
|
152 |
8960
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
153 OLDER VERSIONS |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
154 |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
155 The minimal supported version is Windows XP. Building with older compilers |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
156 might still work, but these instructions might be outdated. |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
157 |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
158 If you need the executable to run on Windows 98 or ME, use the 2003 one |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
159 |msvc-2003-toolkit| or |msvc-2005-express|, and use the source code before |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
160 8.0.0029. |
8960
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
161 |
1668 | 162 Visual C++ Toolkit 2003 *msvc-2003-toolkit* |
714 | 163 ----------------------- |
164 | |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
165 NOTE: this most likely does not work |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
166 |
1668 | 167 You could download the Microsoft Visual C++ Toolkit 2003 from |
714 | 168 http://msdn.microsoft.com/visualc/vctoolkit2003/ |
14792
8eb8200a55b2
patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents:
14222
diff
changeset
|
169 Unfortunately this URL is no longer valid. Unofficial downloads appear to be |
1668 | 170 available from links mentioned on these pages (use at your own risk): |
171 http://www.filewatcher.com/m/VCToolkitSetup.exe.32952488.0.0.html | |
172 http://feargame.net/wiki/index.php?title=Building_Source_with_the_VC2003_Toolkit | |
173 | |
714 | 174 This contains the command-line tools (compiler, linker, CRT headers, |
175 and libraries) for Visual Studio .NET 2003, but not the Visual Studio IDE. | |
176 To compile and debug Vim with the VC2003 Toolkit, you will also need | |
177 |ms-platform-sdk|, |dotnet-1.1-redist|, |dotnet-1.1-sdk|, | |
178 and |windbg-download|. | |
179 | |
1569 | 180 It's easier to download Visual C++ 2008 Express Edition, |msvc-2008-express|, |
181 which is freely available in perpetuity. | |
714 | 182 |
183 The free Code::Blocks IDE works with the VC2003 Toolkit, as described at | |
184 http://wiki.codeblocks.org/index.php?title=Integrating_Microsoft_Visual_Toolkit_2003_with_Code::Blocks_IDE | |
185 (This site also takes you through configuring a number of other | |
186 free C compilers for Win32.) | |
187 | |
188 To compile Vim using the VC2003 Toolkit and Make_mvc.mak, you must first | |
189 execute the following commands in a cmd.exe window (the msvcsetup.bat batch | |
190 file can be used): | |
856 | 191 |
714 | 192 set PATH=%SystemRoot%\Microsoft.NET\Framework\v1.1.4322;%PATH% |
193 call "%VCToolkitInstallDir%vcvars32.bat" | |
194 set MSVCVer=7.1 | |
195 call "%ProgramFiles%\Microsoft Platform SDK\SetEnv.Cmd" | |
196 set LIB=%ProgramFiles%\Microsoft Visual Studio .NET 2003\Vc7\lib;%LIB% | |
197 | |
198 Now you can build Vim with Make_mvc.mak. | |
199 | |
200 | |
856 | 201 Getting the Windows Platform SDK *ms-platform-sdk* |
714 | 202 |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
203 You will also need a copy of the Windows Platform SDK. Specifically, you need |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
204 the Windows Core SDK subset of the Platform SDK, which contains the Windows |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
205 headers and libraries. You need to search for it, Microsoft keeps changing |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
206 the URL. |
714 | 207 |
208 | |
209 Getting the .NET Framework 1.1 Runtime *dotnet-1.1-redist* | |
210 | |
211 You need the .NET Framework 1.1 Redistributable Package from | |
212 http://www.microsoft.com/downloads/details.aspx?familyid=262d25e3-f589-4842-8157-034d1e7cf3a3 | |
213 or from Windows Update: | |
214 http://windowsupdate.microsoft.com/ | |
215 This is needed to install |dotnet-1.1-sdk|. It also contains cvtres.exe, | |
216 which is needed to link Vim. | |
217 | |
218 | |
856 | 219 Getting the .NET Framework 1.1 SDK *dotnet-1.1-sdk* |
714 | 220 |
221 You need the .NET Framework 1.1 SDK from | |
222 http://www.microsoft.com/downloads/details.aspx?familyid=9b3a2ca6-3647-4070-9f41-a333c6b9181d | |
223 This contains some additional libraries needed to compile Vim, | |
224 such as msvcrt.lib. You must install |dotnet-1.1-redist| before | |
225 installing the .NET 1.1 SDK. | |
226 | |
227 | |
856 | 228 Getting the WinDbg debugger *windbg-download* |
714 | 229 |
230 The Debugging Tools for Windows can be downloaded from | |
231 http://www.microsoft.com/whdc/devtools/debugging/default.mspx | |
232 This includes the WinDbg debugger, which you will want if you ever need | |
233 to debug Vim itself. An earlier version of the Debugging Tools | |
234 is also available through the Platform SDK, |ms-platform-sdk|. | |
235 | |
236 | |
1608 | 237 Visual C++ 2005 Express Edition *msvc-2005-express* |
714 | 238 ------------------------------- |
239 | |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
240 NOTE: this most likely does not work |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
241 |
838 | 242 Visual C++ 2005 Express Edition can be downloaded for free from: |
714 | 243 http://msdn.microsoft.com/vstudio/express/visualC/default.aspx |
244 This includes the IDE and the debugger. You will also need | |
245 |ms-platform-sdk|. You can build Vim with Make_mvc.mak. | |
246 | |
247 Instructions for integrating the Platform SDK into VC Express: | |
248 http://msdn.microsoft.com/vstudio/express/visualc/usingpsdk/default.aspx | |
7 | 249 |
250 | |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
251 Visual C++ 2008 Express Edition *msvc-2008-express* |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
252 ------------------------------- |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
253 |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
254 NOTE: this most likely does not work |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
255 |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
256 Visual C++ 2008 Express Edition can be downloaded for free from: |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
257 http://www.microsoft.com/express/downloads/ |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
258 This includes the IDE and the debugger. |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
259 |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
260 To set the environment execute the msvc2008.bat script. You can then build |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
261 Vim with Make_mvc.mak. |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
262 |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
263 For building 64 bit binaries you also need to install the SDK: |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
264 "Microsoft Windows SDK for Windows 7 and .NET Framework 3.5 SP1" |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
265 You don't need the examples and documentation. |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
266 |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
267 If you get an error that Win32.mak can't be found, you have to set the |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
268 variable SDK_INCLUDE_DIR. For example, on Windows 10, installation of MSVC |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
269 puts include files in the following directory: |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
270 set SDK_INCLUDE_DIR=C:\Program Files\Microsoft SDKs\Windows\v6.0A\Include |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
271 |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
272 |
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
|
273 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
|
274 =================== |
6149 | 275 |
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
|
276 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
|
277 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
278 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
|
279 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
|
280 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
281 * 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
|
282 (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
|
283 * 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
|
284 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
285 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
|
286 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
|
287 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
|
288 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
289 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
|
290 $ 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
|
291 |
8eb8200a55b2
patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents:
14222
diff
changeset
|
292 And restart MSYS2 console (select "MSYS2 MSYS" icon from the Start Menu). |
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
|
293 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
|
294 $ 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
|
295 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
296 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
|
297 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
|
298 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
299 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
300 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
|
301 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
302 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
|
303 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
304 * 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
|
305 * 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
|
306 * 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
|
307 |
14792
8eb8200a55b2
patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents:
14222
diff
changeset
|
308 (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
|
309 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
|
310 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
311 $ 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
|
312 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
313 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
|
314 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
315 $ 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
|
316 |
14792
8eb8200a55b2
patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents:
14222
diff
changeset
|
317 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
|
318 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
|
319 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
|
320 (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
|
321 |
14792
8eb8200a55b2
patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents:
14222
diff
changeset
|
322 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
|
323 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
|
324 |
8eb8200a55b2
patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents:
14222
diff
changeset
|
325 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
|
326 |
8eb8200a55b2
patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents:
14222
diff
changeset
|
327 $ 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
|
328 |
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
|
329 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
330 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
|
331 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
332 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
|
333 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
|
334 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
|
335 $ 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
|
336 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
337 |
14792
8eb8200a55b2
patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents:
14222
diff
changeset
|
338 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
|
339 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
340 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
|
341 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
342 * 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
|
343 * 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
|
344 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
345 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
|
346 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
347 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
|
348 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
|
349 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
|
350 |
14792
8eb8200a55b2
patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents:
14222
diff
changeset
|
351 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
|
352 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
|
353 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
354 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
|
355 |
14792
8eb8200a55b2
patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents:
14222
diff
changeset
|
356 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
|
357 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
358 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
|
359 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
360 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
|
361 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
|
362 |
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 |
78449866e9a9
patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents:
13028
diff
changeset
|
364 3. MinGW |
714 | 365 ======== |
366 | |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
367 (written by Ron Aaron: <ronaharon@yahoo.com>, updated by Ken Takata, et al.) |
714 | 368 |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
369 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
|
370 Command Prompt window. (To use MSYS2 console, see above.) |
714 | 371 |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
372 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
|
373 download at: |
6326 | 374 |
375 http://mingw-w64.sourceforge.net/ | |
376 | |
7456
2c5e813e8852
commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents:
6326
diff
changeset
|
377 Or a compiler provided on msys2: |
2c5e813e8852
commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents:
6326
diff
changeset
|
378 |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
379 https://www.msys2.org/ |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
380 |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
381 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
|
382 |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
383 http://www.mingw.org/ |
7456
2c5e813e8852
commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents:
6326
diff
changeset
|
384 |
714 | 385 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
|
386 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
|
387 and Maintenance), System, Advanced, and edit the environment from there. If |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
388 you use the standalone MinGW-w64 compiler, the path may depends on your |
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
389 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
|
390 one of the following): |
7456
2c5e813e8852
commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents:
6326
diff
changeset
|
391 |
12781
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
392 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
|
393 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
|
394 C:\msys64\mingw64\bin (64-bit msys2, targeting 64-bit builds) |
714 | 395 |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
396 Test if gcc is on your path. From a Command Prompt window: |
714 | 397 |
398 C:\> gcc --version | |
6326 | 399 gcc (GCC) 4.8.1 |
714 | 400 |
6326 | 401 C:\> mingw32-make --version |
402 GNU Make 3.82.90 (...etc...) | |
714 | 403 |
404 Now you are ready to rock 'n' roll. Unpack the vim sources (look on | |
405 www.vim.org for exactly which version of the vim files you need). | |
406 | |
407 Change directory to 'vim\src': | |
408 | |
409 C:\> cd vim\src | |
410 C:\VIM\SRC> | |
411 | |
412 and you type: | |
413 | |
6326 | 414 mingw32-make -f Make_ming.mak gvim.exe |
714 | 415 |
416 After churning for a while, you will end up with 'gvim.exe' in the 'vim\src' | |
417 directory. | |
418 | |
419 You should not need to do *any* editing of any files to get vim compiled this | |
420 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
|
421 is NOT recommended on Win32, especially on '95/'98!!!), you can use: |
2035 | 422 |
6326 | 423 mingw32-make -f Make_ming.mak GUI=no vim.exe |
714 | 424 |
425 If you are dismayed by how big the EXE is, I strongly recommend you get 'UPX' | |
426 (also free!) and compress the file (typical compression is 50%). UPX can be | |
427 found at | |
428 http://www.upx.org/ | |
429 | |
3388 | 430 As of 2011, UPX still does not support compressing 64-bit EXE's; if you have |
431 built a 64-bit vim then an alternative to UPX is 'MPRESS'. MPRESS can be found | |
432 at: | |
433 http://www.matcode.com/mpress.htm | |
434 | |
435 | |
714 | 436 ADDITION: NLS support with MinGW |
437 | |
438 (by Eduardo F. Amatria <eferna1@platea.pntic.mec.es>) | |
439 | |
440 If you want National Language Support, read the file src/po/README_mingw.txt. | |
441 You need to uncomment lines in Make_ming.mak to have NLS defined. | |
442 | |
443 | |
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
|
444 4. Cygwin |
714 | 445 ========= |
446 | |
447 Use Make_cyg.mak with Cygwin's GCC. See | |
448 http://users.skynet.be/antoine.mechelynck/vim/compile.htm | |
449 | |
6326 | 450 With Cygnus gcc you should use the Unix Makefile instead (you need to get the |
714 | 451 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
|
452 running on Unix), while with Make_cyg.mak you get a Windows application (like |
714 | 453 with the other makefiles). |
454 | |
455 | |
16606
7e733046db1d
patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents:
16580
diff
changeset
|
456 5. Cross compiling for Win32 from a Linux machine |
714 | 457 ================================================= |
458 | |
459 [Update of 1) needs to be verified] | |
460 | |
461 If you like, you can compile the 'mingw' Win32 version from the comfort of | |
462 your Linux (or other unix) box. To do this, you need to follow a few steps: | |
463 1) Install the mingw32 cross-compiler. See | |
2035 | 464 http://www.mingw.org/wiki/LinuxCrossMinGW |
856 | 465 http://www.libsdl.org/extras/win32/cross/README.txt |
1619 | 466 2) Get and unpack both the Unix sources and the extra archive |
6326 | 467 3) in 'Make_cyg_ming.mak', set 'CROSS' to 'yes' instead of 'no'. |
468 Make further changes to 'Make_cyg_ming.mak' and 'Make_ming.mak' as you | |
469 wish. If your cross-compiler prefix differs from the predefined value, | |
2035 | 470 set 'CROSS_COMPILE' corresponding. |
714 | 471 4) make -f Make_ming.mak gvim.exe |
472 | |
473 Now you have created the Windows binary from your Linux box! Have fun... | |
474 | |
475 | |
16606
7e733046db1d
patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents:
16580
diff
changeset
|
476 6. Building with Python support |
714 | 477 =============================== |
478 | |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
479 For building with MSVC the "Windows Installer" from www.python.org works fine. |
714 | 480 |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
481 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
|
482 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
483 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
|
484 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
|
485 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
|
486 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
487 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
|
488 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
489 nmake -f Make_mvc.mak |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
490 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
|
491 |
15408
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
492 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
|
493 |
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
494 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
|
495 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
|
496 |
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
497 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
|
498 |
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
499 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
|
500 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
|
501 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
|
502 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
|
503 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
|
504 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
|
505 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
|
506 |
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
507 (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
|
508 (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
|
509 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
|
510 |
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
511 |
3847 | 512 (rest written by Ron Aaron: <ronaharon@yahoo.com>) |
513 | |
514 Building with the mingw32 compiler, and the ActiveState ActivePython: | |
714 | 515 http://www.ActiveState.com/Products/ActivePython/ |
516 | |
517 After installing the ActivePython, you will have to create a 'mingw32' | |
518 'libpython20.a' to link with: | |
7456
2c5e813e8852
commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents:
6326
diff
changeset
|
519 cd $PYTHON/libs |
2c5e813e8852
commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents:
6326
diff
changeset
|
520 pexports python20.dll > python20.def |
2c5e813e8852
commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents:
6326
diff
changeset
|
521 dlltool -d python20.def -l libpython20.a |
714 | 522 |
523 Once that is done, edit the 'Make_ming.mak' so the PYTHON variable points to | |
524 the root of the Python installation (C:\Python20, for example). If you are | |
525 cross-compiling on Linux with the mingw32 setup, you need to also convert all | |
526 the 'Include' files to *unix* line-endings. This bash command will do it | |
527 easily: | |
7456
2c5e813e8852
commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents:
6326
diff
changeset
|
528 for fil in *.h ; do vim -e -c 'set ff=unix|w|q' $fil |
714 | 529 |
530 Now just do: | |
7456
2c5e813e8852
commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents:
6326
diff
changeset
|
531 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
|
532 |
2c5e813e8852
commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents:
6326
diff
changeset
|
533 You will end up with a Python-enabled, Win32 version. Enjoy! |
714 | 534 |
535 | |
16606
7e733046db1d
patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents:
16580
diff
changeset
|
536 7. Building with Python3 support |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
537 ================================ |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
538 |
18662
652ac5edf8d0
patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents:
18174
diff
changeset
|
539 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
|
540 Python 3.6 is recommended. |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
541 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
542 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
|
543 |
13018
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
544 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
|
545 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
|
546 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
|
547 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
548 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
|
549 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
550 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
|
551 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
|
552 |
15408
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
553 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
|
554 |
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
555 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
|
556 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
|
557 |
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
558 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
|
559 |
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
560 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
|
561 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
|
562 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
|
563 DYNAMIC_PYTHON3=yes |
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
564 PYTHON3_VER=36 |
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
565 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
|
566 STATIC_STDCPLUS=yes |
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
567 |
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
568 (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
|
569 (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
|
570 libstdc++-6.dll.) |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
571 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
572 |
16606
7e733046db1d
patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents:
16580
diff
changeset
|
573 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
|
574 =========================================== |
7609
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
575 |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
576 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
|
577 |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
578 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
|
579 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
|
580 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
|
581 |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
582 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
|
583 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
|
584 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
|
585 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
|
586 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
|
587 |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
588 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
|
589 |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
590 MZSCHEME: Where Racket is installed. |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
591 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
|
592 DYNAMIC_MZSCHEME: Whether dynamic linking is used. Usually, set to yes. |
11914 | 593 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
|
594 See below for a list of MZSCHEME_VER. |
11914 | 595 The DLL can be found under the lib directory. E.g. |
596 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
|
597 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
|
598 runtime. Default: $(MZSCHEME)\collects |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
599 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
|
600 variable. |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
601 |
12600
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
602 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
|
603 |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
604 Racket ver. | MZSCHEME_VER |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
605 ========================== |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
606 6.3 | 3m_9z0ds0 |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
607 6.6 | 3m_a0solc |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
608 6.8 | 3m_a1zjsw |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
609 6.10 | 3m_a36fs8 |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
610 |
590424e87b65
patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents:
11914
diff
changeset
|
611 |
7609
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
612 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
|
613 |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
614 nmake -f Make_mvc.mak |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
615 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
|
616 MZSCHEME_VER=3m_9z0ds0 |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
617 |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
618 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
|
619 |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
620 mingw32-make -f Make_ming.mak |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
621 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
|
622 MZSCHEME_VER=3m_9z0ds0 |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
623 |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
624 Spaces should be escaped with '\'. |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
625 |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
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 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
|
628 |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
629 (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
|
630 |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
631 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
|
632 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
|
633 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
|
634 |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
635 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
|
636 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
|
637 [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
|
638 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
|
639 (libmzschXXXXXXX.dll). |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
640 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
|
641 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
|
642 |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
643 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
|
644 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
|
645 (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
|
646 |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
647 "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
|
648 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
|
649 |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
650 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
|
651 %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
|
652 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
|
653 |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
654 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
|
655 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
|
656 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
|
657 |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
658 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
|
659 %WINDOWS%\System32 only. |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
660 |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
661 |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
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 9. Building with Lua 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 |
7609
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
666 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
|
667 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
|
668 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
|
669 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
|
670 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
671 1) Download and install LuaBinaries |
7609
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
672 |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
673 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
|
674 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
|
675 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
676 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
|
677 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
|
678 MinGW. |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
679 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
680 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
|
681 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
|
682 |
7609
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
683 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
|
684 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
|
685 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
|
686 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
|
687 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
|
688 |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
689 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
|
690 (or vim.exe) is. |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
691 |
7553
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 2) Build |
7609
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
694 |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
695 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
|
696 |
7609
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
697 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
|
698 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
|
699 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
|
700 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
701 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
|
702 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
703 nmake -f Make_mvc.mak |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
704 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
|
705 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
706 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
|
707 |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
708 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
|
709 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
|
710 |
7609
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
711 |
77a14f3bc18b
commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents:
7553
diff
changeset
|
712 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
|
713 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
714 make -f Make_cyg.mak |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
715 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
|
716 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
717 |
16606
7e733046db1d
patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents:
16580
diff
changeset
|
718 10. Building with Perl support |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
719 ============================== |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
720 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
721 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
|
722 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
|
723 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
724 http://www.activestate.com/activeperl |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
725 http://strawberryperl.com/ |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
726 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
727 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
|
728 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
729 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
|
730 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
|
731 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
|
732 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
733 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
|
734 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
735 nmake -f Make_mvc.mak |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
736 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
|
737 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
738 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
|
739 |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
740 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
|
741 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
|
742 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
743 |
16606
7e733046db1d
patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents:
16580
diff
changeset
|
744 11. Building with Ruby support |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
745 ============================== |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
746 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
747 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
|
748 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
|
749 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
|
750 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
751 http://rubyinstaller.org/ |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
752 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
753 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
|
754 you need some tricks described below. |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
755 (Another binary distribution is ActiveScriptRuby: |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
756 http://www.artonx.org/data/asr/) |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
757 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
758 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
|
759 |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
760 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
|
761 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
|
762 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
|
763 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
|
764 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
|
765 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
766 Ruby version vs. Ruby API version: |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
767 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
768 Ruby ver. | Ruby API ver. |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
769 ========================= |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
770 1.8.X | 1.8 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
771 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
|
772 2.0.0 | 2.0.0 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
773 2.X.Y | 2.X.0 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
774 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
775 (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
|
776 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
777 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
778 A) Using MSVC |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
779 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
780 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
|
781 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
|
782 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
|
783 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
|
784 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
|
785 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
786 1) Download and Install RubyInstaller. |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
787 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
|
788 E.g.: |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
789 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
|
790 |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
791 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
|
792 |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
793 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
|
794 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
795 cd C:\projects |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
796 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
|
797 cd ruby |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
798 win32\configure.bat |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
799 nmake .config.h.time |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
800 |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
801 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
|
802 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
|
803 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
|
804 .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
|
805 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
|
806 .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
|
807 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
808 3) Install the generated config.h. |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
809 |
13018
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
810 For 32-bit version: |
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
811 |
12781
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
812 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
|
813 |
13018
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
814 For 64-bit version: |
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
815 |
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
816 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
|
817 |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
818 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
|
819 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
|
820 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
821 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
|
822 |
13018
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
823 For 32-bit version: |
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
824 |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
825 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
|
826 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
|
827 RUBY_MSVCRT_NAME=msvcrt |
8960
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
828 WINVER=0x501 |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
829 |
13018
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
830 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
|
831 |
8960
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
832 If you set WINVER explicitly, it must be set to >=0x500, when building |
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
833 with Ruby 2.1 or later. (Default is 0x501.) |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
834 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
|
835 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
|
836 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
837 B) Using MinGW |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
838 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
839 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
|
840 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
|
841 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
842 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
|
843 RUBY=C:/Ruby24 DYNAMIC_RUBY=yes RUBY_VER=24 RUBY_API_VER_LONG=2.4.0 |
15408
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
844 WINVER=0x600 |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
845 |
13018
8862bf5adf7b
patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents:
12781
diff
changeset
|
846 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
|
847 If you set WINVER explicitly, it must be set to >=0x500, when building with |
15408
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
848 Ruby 2.1 or later. (Default is 0x600.) |
8960
ea3eb5a815b5
commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents:
8265
diff
changeset
|
849 |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
850 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
851 |
16606
7e733046db1d
patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents:
16580
diff
changeset
|
852 12. Building with Tcl support |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
853 ============================= |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
854 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
855 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
|
856 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
|
857 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
858 http://www.activestate.com/activetcl |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
859 |
15408
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
860 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
|
861 |
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
862 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
|
863 |
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
864 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
|
865 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
|
866 |
cd1b393ddb5f
patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents:
14792
diff
changeset
|
867 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
|
868 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
|
869 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
870 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
|
871 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
|
872 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
|
873 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
|
874 |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
875 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
|
876 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
|
877 the TCL_DLL variable: |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
878 TCL_DLL=tcl86t.dll |
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
879 |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
880 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
|
881 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
882 nmake -f Make_mvc.mak |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
883 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
|
884 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
885 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
|
886 |
12610
c6dc5d62cf5e
patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents:
12600
diff
changeset
|
887 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
|
888 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
|
889 |
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
890 |
19116 | 891 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
|
892 =============================================== |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
893 |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
894 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
|
895 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
|
896 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
|
897 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
|
898 |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
899 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
|
900 |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
901 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
|
902 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
|
903 |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
904 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
|
905 |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
906 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
|
907 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
|
908 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
|
909 |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
910 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
|
911 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
|
912 |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
913 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
|
914 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
|
915 |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
916 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
|
917 |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
918 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
|
919 |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
920 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
|
921 |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
922 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
|
923 |
cfce9ac1d1e8
patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents:
13018
diff
changeset
|
924 |
19116 | 925 14. Windows 3.1x |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
926 ================ |
714 | 927 |
8265
792bc43e69a7
commit https://github.com/vim/vim/commit/6e722e2f948bc51fcb92d98d6f2a089dac01e2bd
Christian Brabandt <cb@256bit.org>
parents:
7609
diff
changeset
|
928 The Windows 3.1x support was removed in patch 7.4.1364. |
714 | 929 |
930 | |
19116 | 931 15. MS-DOS |
7553
f0205ac9818f
commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents:
7456
diff
changeset
|
932 ========== |
7 | 933 |
12781
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
934 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
|
935 work on MS-DOS because of the limited amount of memory available. |
2951 | 936 |
937 | |
19116 | 938 16. Installing after building from sources |
2951 | 939 ========================================== |
940 | |
12781
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
941 [provided by Michael Soyka, updated by Ken Takata] |
2951 | 942 |
943 After you've built the Vim binaries as described above, you're ready to | |
944 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
|
945 using Git, Mercurial or by downloading them as a unix tar file, you must |
19116 | 946 first create a "vim82" directory. If you instead downloaded the sources as |
2951 | 947 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
|
948 correct directory structure. |
2951 | 949 |
19116 | 950 A. Create a Vim "runtime" subdirectory named "vim82" |
2951 | 951 ----------------------------------------------------- |
7456
2c5e813e8852
commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents:
6326
diff
changeset
|
952 If you obtained your Vim sources as zip files, you can skip this step. |
2951 | 953 Otherwise, continue reading. |
954 | |
955 Go to the directory that contains the Vim "src" and "runtime" | |
19116 | 956 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
|
957 |
19116 | 958 Copy the "runtime" files into "vim82": |
959 copy runtime\* vim82 | |
19163 | 960 xcopy /s runtime\* vim82 |
2951 | 961 |
19116 | 962 B. Copy the new binaries into the "vim82" directory |
2951 | 963 ---------------------------------------------------- |
964 Regardless of how you installed the Vim sources, you need to copy the | |
19116 | 965 new binaries you created above into "vim82": |
2951 | 966 |
19116 | 967 copy src\*.exe vim82 |
968 copy src\tee\tee.exe vim82 | |
969 copy src\xxd\xxd.exe vim82 | |
2951 | 970 |
12781
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
971 To install the "Edit with Vim" popup menu, you need both 32-bit and 64-bit |
19116 | 972 versions of gvimext.dll. They should be copied to "vim82\GvimExt32" and |
973 "vim82\GvimExt64" respectively. | |
12781
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
974 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
|
975 |
19116 | 976 mkdir vim82\GvimExt32 |
977 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
|
978 |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
979 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
|
980 |
19116 | 981 mkdir vim82\GvimExt64 |
982 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
|
983 |
19116 | 984 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
|
985 ---------------------------------------------------------- |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
986 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
|
987 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
|
988 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
|
989 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
|
990 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
|
991 |
19116 | 992 vim82\ |
12781
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
993 | libintl-8.dll |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
994 | libiconv-2.dll |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
995 | 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
|
996 | |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
997 + GvimExt32\ |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
998 | libintl-8.dll |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
999 | libiconv-2.dll |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
1000 | libgcc_s_sjlj-1.dll |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
1001 | |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
1002 ` GvimExt64\ |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
1003 libintl-8.dll |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
1004 libiconv-2.dll |
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
1005 |
19116 | 1006 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
|
1007 |
19116 | 1008 D. Move the "vim82" directory into the Vim installation subdirectory |
2951 | 1009 --------------------------------------------------------------------- |
19116 | 1010 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
|
1011 to be installed. Typically, this subdirectory will be named "vim". |
19116 | 1012 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
|
1013 by running its uninstall.exe program. |
2951 | 1014 |
12781
cd41d47e6033
patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents:
12610
diff
changeset
|
1015 E. Install Vim |
2951 | 1016 --------------- |
19116 | 1017 "cd" to your Vim installation subdirectory "vim\vim82" and run the |
2951 | 1018 "install.exe" program. It will ask you a number of questions about |
1019 how you would like to have your Vim setup. Among these are: | |
1020 - You can tell it to write a "_vimrc" file with your preferences in the | |
1021 parent directory. | |
1022 - It can also install an "Edit with Vim" entry in the Windows Explorer | |
1023 popup menu. | |
1024 - You can have it create batch files, so that you can run Vim from the | |
1025 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
|
1026 PATH or add the directory to PATH using the Windows Control Panel. |
2951 | 1027 - Create entries for Vim on the desktop and in the Start menu. |
1028 | |
1029 Happy Vimming! |