blob: ac122c351b518469d1eb9de235b630500573c70a [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
Bram Moolenaar097148e2020-08-11 21:58:20 +020019 1.1. Terminal version
Bram Moolenaar071d4272004-06-13 20:20:40 +000020 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
Bram Moolenaar097148e2020-08-11 21:58:20 +020030 Only '/' is supported as path separator.
Bram Moolenaar071d4272004-06-13 20:20:40 +000031
Bram Moolenaar097148e2020-08-11 21:58:20 +0200321.1 Terminal version (default)
Bram Moolenaar071d4272004-06-13 20:20:40 +000033
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 Moolenaar097148e2020-08-11 21:58:20 +020040 You need at least Xcode 1.5.
Bram Moolenaarfd2ac762006-03-01 22:09:21 +000041
42 To overrule the architecture do this before running make:
43
Bram Moolenaarc9b4b052006-04-30 18:54:39 +000044 ./configure --with-mac-arch=intel
Bram Moolenaarfd2ac762006-03-01 22:09:21 +000045 or
Bram Moolenaarc9b4b052006-04-30 18:54:39 +000046 ./configure --with-mac-arch=ppc
Bram Moolenaarfd2ac762006-03-01 22:09:21 +000047
Bram Moolenaar7e8fd632006-02-18 22:14:51 +000048
Bram Moolenaar097148e2020-08-11 21:58:20 +0200491.2 X-Windows
Bram Moolenaar071d4272004-06-13 20:20:40 +000050
Bram Moolenaar097148e2020-08-11 21:58:20 +020051 You must explicitly tell configure to use a GUI.
Bram Moolenaar071d4272004-06-13 20:20:40 +000052
Bram Moolenaarfd2ac762006-03-01 22:09:21 +000053 cd .../src
Bram Moolenaar7e8fd632006-02-18 22:14:51 +000054 ./configure --disable-darwin --enable-gui=gtk2
Bram Moolenaar071d4272004-06-13 20:20:40 +000055 make; make install
56
Bram Moolenaar097148e2020-08-11 21:58:20 +020057 NOTE: The following GUI options are possible (but might not work):
58 no (for terminal only), motif, athena, nextaw
Bram Moolenaar071d4272004-06-13 20:20:40 +000059 gtk, gtk2, gnome, gnome2,
60
61 NOTE: You need to first install XFree86 and XDarwin.
62 Please visit http://www.XDarwin.org
63
Bram Moolenaar071d4272004-06-13 20:20:40 +000064------------------------------------------------------