vim: src/INSTALLpc.txt annotate

annotate src/INSTALLpc.txt @ 33293:42b89193ab3e v9.0.1912

patch 9.0.1912: Cirrus-CI running out of credits Commit: https://github.com/vim/vim/commit/6f00d17e8d64ed46c85625e8ac38ed0928b32c58 Author: Christian Brabandt <cb@256bit.org> Date: Tue Sep 19 20:16:46 2023 +0200 patch 9.0.1912: Cirrus-CI running out of credits Problem: Cirrus-CI running out of credits Solution: disable Cirrus-CI for now We are running out of credits for Cirrus CI already at the middle of the month and unfortunately this means our CI now consistently fails. This all hapens because cirrus ci is not enforcing the free-tier limits (see also https://cirrus-ci.org/blog/2023/07/17/limiting-free-usage-of-cirrus-ci/). Perhaps at the beginning of the next month we can revisit and enable just a build without testing it. Hopefully this is won't take too many credits and we can at least verify that building works. Signed-off-by: Christian Brabandt <cb@256bit.org>

author	Christian Brabandt <cb@256bit.org>
date	Tue, 19 Sep 2023 20:30:10 +0200
parents	dc0efb0d30bd
children	0f4f084609f1

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

Mercurial > vim

annotate src/INSTALLpc.txt @ 33293:42b89193ab3e v9.0.1912