vim: src/INSTALLpc.txt annotate

annotate src/INSTALLpc.txt @ 8960:ea3eb5a815b5 v7.4.1766

commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Author: Bram Moolenaar <Bram@vim.org> Date: Thu Apr 21 14:34:58 2016 +0200 patch 7.4.1766 Problem: Building instructions for MS-Windows are outdated. Solution: Mention setting SDK_INCLUDE_DIR. (Ben Franklin, closes https://github.com/vim/vim/issues/771) Move outdated instructions further down.

author	Christian Brabandt <cb@256bit.org>
date	Thu, 21 Apr 2016 14:45:04 +0200
parents	792bc43e69a7
children	219dbe63ad2a

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
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	6 More information can be found here: (Very stale now.)
7 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	7
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	8 http://mywebpage.netscape.com/sharppeople/vim/howto/
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
7 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	18
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	19 Contents:
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	20 1. Microsoft Visual C++
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	21 2. Using MinGW
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	22 3. Cygwin
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	23 4. Borland
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	24 5. Cross compiling for Win32 from a Linux machine
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	25 6. Building with Python support
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	26 7. Building with Python3 support
7609 77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	27 8. Building with MzScheme/Racket support
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	28 9. Building with Lua support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	29 10. Building with Perl support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	30 11. Building with Ruby support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	31 12. Building with Tcl support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	32 13. Windows 3.1
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	33 14. MS-DOS
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	34
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	35 15. Installing after building from sources
2951 57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	36
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	37
1668 0b796e045c42 updated for version 7.2b-000 vimboss parents: 1619 diff changeset	38 The currently preferred method is using the free Visual C++ Toolkit 2008
8960 ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	39 \|msvc-2008-express\|, the produced binary runs on most MS-Windows systems.
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	40
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	41
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	42 1. Microsoft Visual C++
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	43 =======================
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	44
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	45 Visual Studio
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	46 -------------
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	47
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	48 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	49 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	50 should also work for VS 4 and VS 5.)
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	51
3847 1003f9b262d7 Update runtime files. Bram Moolenaar <bram@vim.org> parents: 3388 diff changeset	52 Using VS C++ 2008 Express is recommended, the binaries build with that run on
1003f9b262d7 Update runtime files. Bram Moolenaar <bram@vim.org> parents: 3388 diff changeset	53 nearly all platforms. Binaries from later versions may not run on Windows 95
1003f9b262d7 Update runtime files. Bram Moolenaar <bram@vim.org> parents: 3388 diff changeset	54 or XP.
1003f9b262d7 Update runtime files. Bram Moolenaar <bram@vim.org> parents: 3388 diff changeset	55
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	56 To build Vim from the command line with MSVC, use Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	57 Visual Studio installed a batch file called vcvars32.bat, which you must
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	58 run to set up paths for nmake and MSVC.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	59
856 8cd729851562 updated for version 7.0g vimboss parents: 838 diff changeset	60 nmake -f Make_mvc.mak console Win32 SDK or Microsoft Visual C++
8cd729851562 updated for version 7.0g vimboss parents: 838 diff changeset	61 nmake -f Make_mvc.mak GUI=yes GUI Microsoft Visual C++
8cd729851562 updated for version 7.0g vimboss parents: 838 diff changeset	62 nmake -f Make_mvc.mak OLE=yes OLE Microsoft Visual C++
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	63 nmake -f Make_mvc.mak PERL=C:\Perl PYTHON=C:\Python etc.
856 8cd729851562 updated for version 7.0g vimboss parents: 838 diff changeset	64 Perl, Python, etc.
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	65
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	66 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	67 debug support. Debugging with MS Devstudio is provided by Make_dvc.mak.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	68 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	69
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	70 For compiling Gvim with IME support on far-east Windows, add IME=yes
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	71 to the parameters you pass to Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	72
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	73 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	74 (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	75 far more configuration.) Make_ivc.mak can also be built with nmake.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	76
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	77 nmake -f Make_ivc.mak CFG="Vim - Win32 Release gvim"
856 8cd729851562 updated for version 7.0g vimboss parents: 838 diff changeset	78 GUI Microsoft Visual C++ 4.x or later
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	79 nmake -f Make_ivc.mak CFG="Vim - Win32 Release gvim OLE"
856 8cd729851562 updated for version 7.0g vimboss parents: 838 diff changeset	80 OLE Microsoft Visual C++ 4.x or later
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	81
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	82 See the specific files for comments and options.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	83
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	84 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	85 Ron Aaron; they have been tested.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	86
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	87
8960 ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	88 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	89 -------------------------------
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	90
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	91 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	92 http://www.microsoft.com/express/downloads/
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	93 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	94
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	95 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	96 Vim with Make_mvc.mak.
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	97
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	98 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	99 "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	100 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	101
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	102 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	103 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	104 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	105 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	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++ 2010 Express Edition msvc-2010-express
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	109 -------------------------------
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	110
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	111 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	112 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	113 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	114
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	115 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	116 Vim with Make_mvc.mak.
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	117
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	118
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	119 Targeting Windows XP with new MSVC new-msvc-windows-xp
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	120 ----------------------------------
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	121
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	122 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	123 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	124 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	125 follows:
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	126 LINK ... /subsystem:console,5.01
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 Make_mvc.mak now supports a macro SUBSYSTEM_VER to pass the Windows version.
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	129 Use lines like follows to target Windows XP (assuming using Visual C++ 2012
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	130 under 64-bit Windows):
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	131 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	132 set SDK_INCLUDE_DIR=%WinSdk71%\Include
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	133 set INCLUDE=%WinSdk71%\Include;%INCLUDE%
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	134 set LIB=%WinSdk71%\Lib;%LIB%
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	135 set PATH=%WinSdk71%\Bin;%PATH%
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	136 set CL=/D_USING_V110_SDK71_
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	137 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	138
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	139 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	140 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	141
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	142
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	143 OLDER VERSIONS
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 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	146 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	147
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	148 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	149 \|msvc-2003-toolkit\|.
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	150
1668 0b796e045c42 updated for version 7.2b-000 vimboss parents: 1619 diff changeset	151 Visual C++ Toolkit 2003 msvc-2003-toolkit
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	152 -----------------------
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	153
1668 0b796e045c42 updated for version 7.2b-000 vimboss parents: 1619 diff changeset	154 You could download the Microsoft Visual C++ Toolkit 2003 from
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	155 http://msdn.microsoft.com/visualc/vctoolkit2003/
1668 0b796e045c42 updated for version 7.2b-000 vimboss parents: 1619 diff changeset	156 Unfortunately this URL is no longer valid. Inofficial downloads appear to be
0b796e045c42 updated for version 7.2b-000 vimboss parents: 1619 diff changeset	157 available from links mentioned on these pages (use at your own risk):
0b796e045c42 updated for version 7.2b-000 vimboss parents: 1619 diff changeset	158 http://www.filewatcher.com/m/VCToolkitSetup.exe.32952488.0.0.html
0b796e045c42 updated for version 7.2b-000 vimboss parents: 1619 diff changeset	159 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	160
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	161 This contains the command-line tools (compiler, linker, CRT headers,
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	162 and libraries) for Visual Studio .NET 2003, but not the Visual Studio IDE.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	163 To compile and debug Vim with the VC2003 Toolkit, you will also need
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	164 \|ms-platform-sdk\|, \|dotnet-1.1-redist\|, \|dotnet-1.1-sdk\|,
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	165 and \|windbg-download\|.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	166
1569 9fbb40a1228a updated for version 7.1-282 vimboss parents: 856 diff changeset	167 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	168 which is freely available in perpetuity.
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	169
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	170 The free Code::Blocks IDE works with the VC2003 Toolkit, as described at
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	171 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	172 (This site also takes you through configuring a number of other
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	173 free C compilers for Win32.)
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	174
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	175 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	176 execute the following commands in a cmd.exe window (the msvcsetup.bat batch
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	177 file can be used):
856 8cd729851562 updated for version 7.0g vimboss parents: 838 diff changeset	178
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	179 set PATH=%SystemRoot%\Microsoft.NET\Framework\v1.1.4322;%PATH%
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	180 call "%VCToolkitInstallDir%vcvars32.bat"
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	181 set MSVCVer=7.1
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	182 call "%ProgramFiles%\Microsoft Platform SDK\SetEnv.Cmd"
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	183 set LIB=%ProgramFiles%\Microsoft Visual Studio .NET 2003\Vc7\lib;%LIB%
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	184
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	185 Now you can build Vim with Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	186
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	187
856 8cd729851562 updated for version 7.0g vimboss parents: 838 diff changeset	188 Getting the Windows Platform SDK ms-platform-sdk
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	189
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	190 You will also need a copy of the Windows Platform SDK from
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	191 http://www.microsoft.com/msdownload/platformsdk/sdkupdate/
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	192 Specifically, you need the Windows Core SDK subset of the Platform SDK,
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	193 which contains the Windows headers and libraries.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	194
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	195
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	196 Getting the .NET Framework 1.1 Runtime dotnet-1.1-redist
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	197
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	198 You need the .NET Framework 1.1 Redistributable Package from
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	199 http://www.microsoft.com/downloads/details.aspx?familyid=262d25e3-f589-4842-8157-034d1e7cf3a3
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	200 or from Windows Update:
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	201 http://windowsupdate.microsoft.com/
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	202 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	203 which is needed to link Vim.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	204
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	205
856 8cd729851562 updated for version 7.0g vimboss parents: 838 diff changeset	206 Getting the .NET Framework 1.1 SDK dotnet-1.1-sdk
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	207
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	208 You need the .NET Framework 1.1 SDK from
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	209 http://www.microsoft.com/downloads/details.aspx?familyid=9b3a2ca6-3647-4070-9f41-a333c6b9181d
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	210 This contains some additional libraries needed to compile Vim,
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	211 such as msvcrt.lib. You must install \|dotnet-1.1-redist\| before
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	212 installing the .NET 1.1 SDK.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	213
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	214
856 8cd729851562 updated for version 7.0g vimboss parents: 838 diff changeset	215 Getting the WinDbg debugger windbg-download
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	216
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	217 The Debugging Tools for Windows can be downloaded from
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	218 http://www.microsoft.com/whdc/devtools/debugging/default.mspx
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	219 This includes the WinDbg debugger, which you will want if you ever need
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	220 to debug Vim itself. An earlier version of the Debugging Tools
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	221 is also available through the Platform SDK, \|ms-platform-sdk\|.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	222
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	223
1608 152883db0edf updated for version 7.1-321 vimboss parents: 1569 diff changeset	224 Visual C++ 2005 Express Edition msvc-2005-express
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	225 -------------------------------
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	226
838 8e5830943bff updated for version 7.0e04 vimboss parents: 714 diff changeset	227 Visual C++ 2005 Express Edition can be downloaded for free from:
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	228 http://msdn.microsoft.com/vstudio/express/visualC/default.aspx
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	229 This includes the IDE and the debugger. You will also need
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	230 \|ms-platform-sdk\|. You can build Vim with Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	231
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	232 Instructions for integrating the Platform SDK into VC Express:
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	233 http://msdn.microsoft.com/vstudio/express/visualc/usingpsdk/default.aspx
7 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	234
3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	235
6149 4c845a1600d2 updated for version 7.4.412 Bram Moolenaar <bram@vim.org> parents: 3847 diff changeset	236
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	237 2. MinGW
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	238 ========
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	239
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	240 (written by Ron Aaron: <ronaharon@yahoo.com>)
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	241
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	242 This is about how to produce a Win32 binary of gvim with MinGW.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	243
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	244 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	245 at:
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	246
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	247 http://www.mingw.org/
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	248
6326 112c80234ce3 updated for version 7.4.496 Bram Moolenaar <bram@vim.org> parents: 6149 diff changeset	249 or you can use 'MinGW-w64' compiler.
112c80234ce3 updated for version 7.4.496 Bram Moolenaar <bram@vim.org> parents: 6149 diff changeset	250
112c80234ce3 updated for version 7.4.496 Bram Moolenaar <bram@vim.org> parents: 6149 diff changeset	251 http://mingw-w64.sourceforge.net/
112c80234ce3 updated for version 7.4.496 Bram Moolenaar <bram@vim.org> parents: 6149 diff changeset	252
7456 2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	253 Or a compiler provided on msys2:
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	254
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	255 https://msys2.github.io/
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	256
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	257 Once you have downloaded the compiler binaries, unpack them on your hard disk
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	258 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	259 your AUTOEXEC.BAT file with a line like:
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	260
6326 112c80234ce3 updated for version 7.4.496 Bram Moolenaar <bram@vim.org> parents: 6149 diff changeset	261 set PATH=C:\MinGW\bin;%PATH%
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	262
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	263 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	264 System, Advanced, and edit the environment from there. If you use msys2
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	265 compilers, set your installed paths:
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	266
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	267 C:\msys2\mingw32\bin
8960 ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	268 or
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	269 C:\msys64\mingw32\bin
7456 2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	270
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	271 for 32bit. And 64bit:
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	272
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	273 C:\msys2\mingw64\bin
8960 ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	274 or
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	275 C:\msys64\mingw64\bin
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	276
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	277 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	278
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	279 C:\> gcc --version
6326 112c80234ce3 updated for version 7.4.496 Bram Moolenaar <bram@vim.org> parents: 6149 diff changeset	280 gcc (GCC) 4.8.1
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	281
6326 112c80234ce3 updated for version 7.4.496 Bram Moolenaar <bram@vim.org> parents: 6149 diff changeset	282 C:\> mingw32-make --version
112c80234ce3 updated for version 7.4.496 Bram Moolenaar <bram@vim.org> parents: 6149 diff changeset	283 GNU Make 3.82.90 (...etc...)
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	284
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	285 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	286 www.vim.org for exactly which version of the vim files you need).
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	287
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	288 Change directory to 'vim\src':
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	289
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	290 C:\> cd vim\src
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	291 C:\VIM\SRC>
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	292
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	293 and you type:
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	294
6326 112c80234ce3 updated for version 7.4.496 Bram Moolenaar <bram@vim.org> parents: 6149 diff changeset	295 mingw32-make -f Make_ming.mak gvim.exe
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	296
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	297 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	298 directory.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	299
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	300 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	301 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	302 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	303
6326 112c80234ce3 updated for version 7.4.496 Bram Moolenaar <bram@vim.org> parents: 6149 diff changeset	304 mingw32-make -f Make_ming.mak GUI=no vim.exe
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	305
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	306 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	307 (also free!) and compress the file (typical compression is 50%). UPX can be
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	308 found at
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	309 http://www.upx.org/
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	310
3388 981c7ad9dd48 updated for version 7.3.460 Bram Moolenaar <bram@vim.org> parents: 2965 diff changeset	311 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	312 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	313 at:
981c7ad9dd48 updated for version 7.3.460 Bram Moolenaar <bram@vim.org> parents: 2965 diff changeset	314 http://www.matcode.com/mpress.htm
981c7ad9dd48 updated for version 7.3.460 Bram Moolenaar <bram@vim.org> parents: 2965 diff changeset	315
981c7ad9dd48 updated for version 7.3.460 Bram Moolenaar <bram@vim.org> parents: 2965 diff changeset	316
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	317 ADDITION: NLS support with MinGW
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	318
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	319 (by Eduardo F. Amatria <eferna1@platea.pntic.mec.es>)
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	320
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	321 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	322 You need to uncomment lines in Make_ming.mak to have NLS defined.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	323
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	324
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	325 3. Cygwin
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	326 =========
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	327
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	328 Use Make_cyg.mak with Cygwin's GCC. See
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	329 http://users.skynet.be/antoine.mechelynck/vim/compile.htm
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	330
6326 112c80234ce3 updated for version 7.4.496 Bram Moolenaar <bram@vim.org> parents: 6149 diff changeset	331 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	332 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	333 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	334 with the other makefiles).
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	335
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	336
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	337 4. Borland
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	338 ===========
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	339
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	340 Use Make_bc5.mak with Borland C++ 5.x. See
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	341 http://users.skynet.be/antoine.mechelynck/vim/compile.htm
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	342
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	343
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	344 5. Cross compiling for Win32 from a Linux machine
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	345 =================================================
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	346
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	347 [Update of 1) needs to be verified]
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	348
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	349 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	350 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	351 1) Install the mingw32 cross-compiler. See
2035 ca7d02cd5e49 Minor text file updates. Bram Moolenaar <bram@zimbu.org> parents: 1668 diff changeset	352 http://www.mingw.org/wiki/LinuxCrossMinGW
856 8cd729851562 updated for version 7.0g vimboss parents: 838 diff changeset	353 http://www.libsdl.org/extras/win32/cross/README.txt
1619 b9740fb41986 updated for version 7.2a vimboss parents: 1608 diff changeset	354 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	355 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	356 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	357 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	358 set 'CROSS_COMPILE' corresponding.
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	359 4) make -f Make_ming.mak gvim.exe
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	360
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	361 Now you have created the Windows binary from your Linux box! Have fun...
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	362
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	363
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	364 6. Building with Python support
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	365 ===============================
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	366
3847 1003f9b262d7 Update runtime files. Bram Moolenaar <bram@vim.org> parents: 3388 diff changeset	367 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	368 works fine.
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	369
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	370 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	371
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	372 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	373 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	374 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	375
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	376 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	377
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	378 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	379 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	380
3847 1003f9b262d7 Update runtime files. Bram Moolenaar <bram@vim.org> parents: 3388 diff changeset	381 (rest written by Ron Aaron: <ronaharon@yahoo.com>)
1003f9b262d7 Update runtime files. Bram Moolenaar <bram@vim.org> parents: 3388 diff changeset	382
1003f9b262d7 Update runtime files. Bram Moolenaar <bram@vim.org> parents: 3388 diff changeset	383 Building with the mingw32 compiler, and the ActiveState ActivePython:
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	384 http://www.ActiveState.com/Products/ActivePython/
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	385
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	386 After installing the ActivePython, you will have to create a 'mingw32'
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	387 'libpython20.a' to link with:
7456 2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	388 cd $PYTHON/libs
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	389 pexports python20.dll > python20.def
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	390 dlltool -d python20.def -l libpython20.a
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	391
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	392 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	393 the root of the Python installation (C:\Python20, for example). If you are
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	394 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	395 the 'Include' files to unix line-endings. This bash command will do it
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	396 easily:
7456 2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	397 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	398
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	399 Now just do:
7456 2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	400 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	401
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	402 And if you use msys2 to build python support (as one line):
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	403
7456 2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	404 mingw32-make -f Make_ming.mak PYTHON=c:/msys64/mingw64
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	405 PYTHON_HOME=c:/msys64/mingw64
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	406 PYTHONINC=-Ic:/msys64/mingw64/include/python2.7
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	407 DYNAMIC_PYTHON=yes
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	408 PYTHON_VER=27
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	409 DYNAMIC_PYTHON_DLL=libpython2.7.dll
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	410 ARCH=x86-64
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	411 STATIC_STDCPLUS=yes
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	412
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	413 You will end up with a Python-enabled, Win32 version. Enjoy!
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	414
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	415
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	416 7. Building with Python3 support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	417 ================================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	418
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	419 For building with MSVC 2008 the "Windows Installer" from www.python.org
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	420 works fine. Python 3.4 is recommended.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	421
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	422 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	423
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	424 PYTHON3: Where Python3 is installed. E.g. C:\Python34
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	425 DYNAMIC_PYTHON3: Whether dynamic linking is used. Usually, set to yes.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	426 PYTHON3_VER: Python3 version. E.g. 34 for Python 3.4.X.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	427
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	428 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	429
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	430 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	431 PYTHON3=C:\Python34 DYNAMIC_PYTHON3=yes PYTHON3_VER=34
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	432
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	433
7609 77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	434 8. Building with MzScheme/Racket support
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	435 ========================================
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	436
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	437 1) Building with MzScheme support
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	438
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	439 (written by Sergey Khorev <sergey.khorev@gmail.com>)
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	440
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	441 Vim with MzScheme (http://www.plt-scheme.org/software/mzscheme) support can
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	442 be built with either MSVC, or MinGW, or Cygwin. Supported versions are 205 and
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	443 above (including 299 and 30x series).
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	444
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	445 The MSVC build is quite straightforward. Simply invoke (in one line)
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	446 nmake -fMake_mvc.mak MZSCHEME=<Path-to-MzScheme>
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	447 [MZSCHEME_VER=<MzScheme-version>] [DYNAMIC_MZSCHEME=<yes or no>]
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	448 where <MzScheme-version> is the last seven characters from MzScheme dll name
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	449 (libmzschXXXXXXX.dll).
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	450 If DYNAMIC_MZSCHEME=yes, resulting executable will not depend on MzScheme
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	451 DLL's, but will load them in runtime on demand.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	452
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	453 Building dynamic MzScheme support on MinGW and Cygwin is similar. Take into
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	454 account that <Path-to-MzScheme> should contain slashes rather than backslashes
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	455 (e.g. d:/Develop/MzScheme)
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	456
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	457 "Static" MzScheme support (Vim executable will depend on MzScheme DLLs
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	458 explicitly) on MinGW and Cygwin requires additional step.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	459
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	460 libmzschXXXXXXX.dll and libmzgcXXXXXXX.dll should be copied from
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	461 %WINDOWS%\System32 to other location (either build directory, some temporary
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	462 dir or even MzScheme home).
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	463
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	464 Pass that path as MZSCHEME_DLLS parameter for Make. E.g.,
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	465 make -f Make_cyg.mak MZSCHEME=d:/Develop/MzScheme MZSCHEME_VER=209_000
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	466 MZSCHEME_DLLS=c:/Temp DYNAMIC_MZSCHEME=no
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	467
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	468 After a successful build, these dlls can be freely removed, leaving them in
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	469 %WINDOWS%\System32 only.
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	470
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	471
7609 77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	472 2) Building with Racket support
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	473
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	474 MzScheme and PLT Scheme names have been rebranded as Racket. Vim with Racket
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	475 (https://racket-lang.org/) support can be built with either MSVC or MinGW (or
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	476 Cygwin).
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	477
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	478 You need to set the following variables:
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	479
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	480 MZSCHEME: Where Racket is installed.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	481 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	482 DYNAMIC_MZSCHEME: Whether dynamic linking is used. Usually, set to yes.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	483 MZSCHEME_VER: Racket DLL version. E.g. 3m_9z0ds0 for Racket 6.3.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	484 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	485 runtime. Default: $(MZSCHEME)\collects
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	486 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	487 variable.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	488
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	489 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	490
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	491 nmake -f Make_mvc.mak
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	492 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	493 MZSCHEME_VER=3m_9z0ds0
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	494
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	495 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	496
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	497 mingw32-make -f Make_ming.mak
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	498 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	499 MZSCHEME_VER=3m_9z0ds0
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	500
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	501 Spaces should be escaped with '\'.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	502
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	503
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	504 9. Building with Lua support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	505 ============================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	506
7609 77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	507 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	508 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	509 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	510 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	511
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	512 1) Download and install LuaBinaries
7609 77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	513
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	514 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	515 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	516
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	517 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	518 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	519 MinGW.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	520
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	521 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	522 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	523
7609 77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	524 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	525 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	526 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	527 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	528 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	529
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	530 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	531 (or vim.exe) is.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	532
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	533
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	534 2) Build
7609 77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	535
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	536 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	537
7609 77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	538 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	539 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	540 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	541
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	542 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	543
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	544 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	545 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	546
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	547 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	548
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	549 mingw32-make -f Make_mingw.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	550 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	551
7609 77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	552
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d Christian Brabandt <cb@256bit.org> parents: 7553 diff changeset	553 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	554
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	555 make -f Make_cyg.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	556 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	557
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	558
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	559 10. Building with Perl support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	560 ==============================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	561
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	562 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	563 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	564
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	565 http://www.activestate.com/activeperl
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	566 http://strawberryperl.com/
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	567
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	568 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	569
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	570 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	571 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	572 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	573
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	574 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	575
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	576 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	577 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	578
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	579 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	580
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	581 mingw32-make -f Make_mingw.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	582 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	583
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	584
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	585 11. Building with Ruby support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	586 ==============================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	587
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	588 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	589 Ruby doesn't provide the official Windows binaries. The most widely used
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	590 Windows binaries might be RubyInstaller.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	591
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	592 http://rubyinstaller.org/
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	593
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	594 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	595 you need some tricks described below.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	596 (Another binary distribution is ActiveScriptRuby:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	597 http://www.artonx.org/data/asr/)
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	598
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	599 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	600
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	601 RUBY: Where ruby is installed. E.g. C:\Ruby22
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	602 DYNAMIC_RUBY: 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	603 RUBY_VER: Ruby version. E.g. 22 for Ruby 2.2.X.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	604 RUBY_VER_LONG: Ruby API version in a long format.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	605 E.g. 2.2.0 for Ruby 2.2.X.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	606
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	607 Ruby version vs. Ruby API version:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	608
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	609 Ruby ver. \| Ruby API ver.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	610 =========================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	611 1.8.X \| 1.8
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	612 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	613 2.0.0 \| 2.0.0
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	614 2.X.Y \| 2.X.0
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	615
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	616 (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	617
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	618
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	619 A) Using MSVC
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	620
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	621 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	622 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	623 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	624 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	625 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	626
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	627 1) Download and Install RubyInstaller.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	628 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	629 E.g.:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	630 C:\Ruby22 (32-bit) or C:\Ruby22-x64 (64-bit)
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	631
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	632 Ruby 2.2.X is used in this example.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	633
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	634 2) Download Ruby 2.2.X's source code and generate config.h:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	635
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	636 cd C:\projects
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	637 git clone https://github.com/ruby/ruby.git -b ruby_2_2
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	638 cd ruby
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	639 win32\configure.bat
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	640 nmake .config.h.time
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	641
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	642 Note that ruby_2_2 is the branch name for Ruby 2.2.X's source code.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	643 There is no need to build whole Ruby, just config.h is needed.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	644 If you use 32-bit MSVC10, the config.h is generated in the
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	645 .ext\include\i386-mswin32_100 directory.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	646
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	647 3) Install the generated config.h.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	648
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	649 xcopy /s .ext\include C:\Ruby22\include\ruby-2.2.0
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	650
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	651 Note that 2.2.0 is Ruby API version of Ruby 2.2.X.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	652
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	653 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	654
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	655 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	656 RUBY=C:\Ruby22 DYNAMIC_RUBY=yes RUBY_VER=22 RUBY_VER_LONG=2.2.0
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	657 RUBY_MSVCRT_NAME=msvcrt
8960 ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	658 WINVER=0x501
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	659
8960 ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	660 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	661 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	662 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	663 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	664
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	665 B) Using MinGW
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	666
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	667 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	668 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	669
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	670 mingw32-make -f Make_ming.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	671 RUBY=C:/Ruby22 DYNAMIC_RUBY=yes RUBY_VER=22 RUBY_VER_LONG=2.2.0
8960 ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	672 WINVER=0x501
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	673
8960 ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	674 If you set WINVER explicitly, it must be set to >=0x500, when building with
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	675 Ruby 2.1 or later. (Default is 0x501.)
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1 Christian Brabandt <cb@256bit.org> parents: 8265 diff changeset	676
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	677
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	678
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	679 12. Building with Tcl support
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
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	682 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	683 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	684
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	685 http://www.activestate.com/activetcl
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 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	688
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	689 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	690 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	691 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	692 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	693
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	694 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	695
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	696 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	697 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	698
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	699 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	700
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	701 mingw32-make -f Make_mingw.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	702 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	703
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	704
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	705 13. Windows 3.1x
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	706 ================
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	707
8265 792bc43e69a7 commit https://github.com/vim/vim/commit/6e722e2f948bc51fcb92d98d6f2a089dac01e2bd Christian Brabandt <cb@256bit.org> parents: 7609 diff changeset	708 The Windows 3.1x support was removed in patch 7.4.1364.
714 0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	709
0f9f4761ad9c updated for version 7.0216 vimboss parents: 605 diff changeset	710
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	711 14. MS-DOS
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	712 ==========
7 3fc0f57ecb91 updated for version 7.0001 vimboss parents: diff changeset	713
8265 792bc43e69a7 commit https://github.com/vim/vim/commit/6e722e2f948bc51fcb92d98d6f2a089dac01e2bd Christian Brabandt <cb@256bit.org> parents: 7609 diff changeset	714 The MS-DOS support was removed in patch 7.4.1399.
2951 57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	715
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	716
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	717 15. Installing after building from sources
2951 57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	718 ==========================================
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	719
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	720 [provided by Michael Soyka]
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	721
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	722 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	723 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	724 using Git, Mercurial or by downloading them as a unix tar file, you must
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	725 first create a "vim74" 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	726 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	727 correct directory structure.
2951 57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	728
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	729 A. Create a Vim "runtime" subdirectory named "vim74"
2951 57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	730 -----------------------------------------------------
7456 2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	731 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	732 Otherwise, continue reading.
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	733
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	734 Go to the directory that contains the Vim "src" and "runtime"
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	735 directories and create a new subdirectory named "vim74".
7456 2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210 Christian Brabandt <cb@256bit.org> parents: 6326 diff changeset	736
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	737 Copy the "runtime" files into "vim74":
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	738 copy runtime\* vim74
2951 57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	739
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	740 B. Copy the new binaries into the "vim74" directory
2951 57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	741 ----------------------------------------------------
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	742 Regardless of how you installed the Vim sources, you need to copy the
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	743 new binaries you created above into "vim74":
2951 57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	744
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	745 copy src\*.exe vim74
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	746 copy src\GvimExt\gvimext.dll vim74
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	747 copy src\xxd\xxd.exe vim74
2951 57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	748
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	749 C. Move the "vim74" directory into the Vim installation subdirectory
2951 57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	750 ---------------------------------------------------------------------
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	751 Move the "vim74" 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	752 to be installed. Typically, this subdirectory will be named "vim".
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	753 If you already have a "vim74" 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	754 by running its uninstal.exe program.
2951 57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	755
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	756 D. Install Vim
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	757 ---------------
7553 f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df Christian Brabandt <cb@256bit.org> parents: 7456 diff changeset	758 "cd" to your Vim installation subdirectory "vim\vim74" and run the
2951 57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	759 "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	760 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	761 - 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	762 parent directory.
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	763 - 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	764 popup menu.
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	765 - 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	766 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	767 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	768 - 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	769
57a7998e0fa8 updated for version 7.3.248 Bram Moolenaar <bram@vim.org> parents: 2871 diff changeset	770 Happy Vimming!

Mercurial > vim

annotate src/INSTALLpc.txt @ 8960:ea3eb5a815b5 v7.4.1766