blob: e957682a145597d9aaadb5e5b730aeec8b408534 [file] [log] [blame]
Bram Moolenaar071d4272004-06-13 20:20:40 +00001INSTALLmac.txt - Installation of Vim on Macintosh
2
3This file contains instructions for compiling Vim. If you already have an
4executable version of Vim, you don't need this.
5
Bram Moolenaard7a08a22016-01-03 22:51:16 +01006First, make sure you've installed Xcode or CommandLineToots. If not, open a
7terminal and do
Bram Moolenaar071d4272004-06-13 20:20:40 +00008
Bram Moolenaard7a08a22016-01-03 22:51:16 +01009 $ make --version
10
11A window pops up instructing you to install the developer tools.
12
Bram Moolenaar071d4272004-06-13 20:20:40 +000013
14----------------------------------------------------------------------------
15Summary
16----------------------------------------------------------------------------
17
181 MacOS X
19 1.1. Carbon interface
20 1.2. X (Athena, GTK, Motif) or plain text.
21
Bram Moolenaar9372a112005-12-06 19:59:18 +000022MacOS Classic is no longer supported. If you really want it use Vim 6.4.
Bram Moolenaar071d4272004-06-13 20:20:40 +000023
24----------------------------------------------------------------------------
251 MacOS X
26----------------------------------------------------------------------------
27
281.0 Considerations
29
30 Only '/' supported as path separator.
31
321.1 Carbon interface (default)
33
34 You can compile vim with the standard Unix routine:
Bram Moolenaarfd2ac762006-03-01 22:09:21 +000035 cd .../src
36 make
Bram Moolenaard7a08a22016-01-03 22:51:16 +010037 make test
38 sudo make install
Bram Moolenaar071d4272004-06-13 20:20:40 +000039
Bram Moolenaard7a08a22016-01-03 22:51:16 +010040 "make" will create a working Vim.app application bundle in the src
Bram Moolenaar071d4272004-06-13 20:20:40 +000041 directory. You can move this bundle (the Vim.app directory) anywhere
Bram Moolenaard7a08a22016-01-03 22:51:16 +010042 you want. Or use "make install" to move it to /Applications.
Bram Moolenaar071d4272004-06-13 20:20:40 +000043
Bram Moolenaar7e8fd632006-02-18 22:14:51 +000044 You need at least Xcode 1.5 to compile Vim 7.0.
45
Bram Moolenaarfd2ac762006-03-01 22:09:21 +000046 Configure will create a universal binary if possible. This requires
47 installing the universal SDK (currently for 10.4).
48
49 To overrule the architecture do this before running make:
50
Bram Moolenaarc9b4b052006-04-30 18:54:39 +000051 ./configure --with-mac-arch=intel
Bram Moolenaarfd2ac762006-03-01 22:09:21 +000052 or
Bram Moolenaarc9b4b052006-04-30 18:54:39 +000053 ./configure --with-mac-arch=ppc
Bram Moolenaarfd2ac762006-03-01 22:09:21 +000054
Bram Moolenaar7e8fd632006-02-18 22:14:51 +000055
Bram Moolenaar071d4272004-06-13 20:20:40 +0000561.2 X-Windows or Plain Text
57
58 If you do not want the Carbon interface, you must explicitly tell
59 configure to use a different GUI.
60
Bram Moolenaarfd2ac762006-03-01 22:09:21 +000061 cd .../src
Bram Moolenaar7e8fd632006-02-18 22:14:51 +000062 ./configure --disable-darwin --enable-gui=gtk2
Bram Moolenaar071d4272004-06-13 20:20:40 +000063 make; make install
64
65 NOTE: The following GUI options are supported:
66 no (for text), motif, athena, nextaw
67 gtk, gtk2, gnome, gnome2,
68
69 NOTE: You need to first install XFree86 and XDarwin.
70 Please visit http://www.XDarwin.org
71
Bram Moolenaar071d4272004-06-13 20:20:40 +000072------------------------------------------------------