vim: src/INSTALLpc.txt annotate

annotate src/INSTALLpc.txt @ 16304:c83169bdb290 v8.1.1157

patch 8.1.1157: Unicode tables are out of date commit https://github.com/vim/vim/commit/f9b89b467965802b8d14251c0dd944343796edcd Author: Bram Moolenaar <Bram@vim.org> Date: Fri Apr 12 20:08:55 2019 +0200 patch 8.1.1157: Unicode tables are out of date Problem: Unicode tables are out of date. Solution: Update to Unicode 12. (Christian Brabandt, closes https://github.com/vim/vim/issues/4240)

author	Bram Moolenaar <Bram@vim.org>
date	Fri, 12 Apr 2019 20:15:07 +0200
parents	081522b02c2d
children	09f560dde6be

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

Mercurial > vim

annotate src/INSTALLpc.txt @ 16304:c83169bdb290 v8.1.1157