annotate src/INSTALLmac.txt @ 29234:96ff6c230a66 v8.2.5136

patch 8.2.5136: debugger test fails when run with valgrind Commit: https://github.com/vim/vim/commit/e366ed4f2c6fa8cb663f1b9599b39d57ddbd8a2a Author: Bram Moolenaar <Bram@vim.org> Date: Sun Jun 19 20:13:56 2022 +0100 patch 8.2.5136: debugger test fails when run with valgrind Problem: Debugger test fails when run with valgrind. Solution: Wait longer when using valgrind.
author Bram Moolenaar <Bram@vim.org>
date Sun, 19 Jun 2022 21:15:03 +0200
parents 9f41bfdbc6fc
children 2a17771529af
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
1 INSTALLmac.txt - Installation of Vim on Apple MacOS
7
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
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
6 MacOS Classic is no longer supported. If you really want it use Vim 6.4.
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
7 Only '/' is supported as path separator.
7482
52d76b2f56c7 commit https://github.com/vim/vim/commit/d7a08a23bf210147e846c74af570bd219e4903da
Christian Brabandt <cb@256bit.org>
parents: 856
diff changeset
8
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 ----------------------------------------------------------------------------
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
11 Prerequisites
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 ----------------------------------------------------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
14 Make sure you've installed Xcode and CommandLineTools. You can download Xcode
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
15 from the Mac App Store, for free.
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
16
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
17 To check for CommandLineTools open a terminal and do:
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
18
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
19 $ make --version
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
21 If not installed yet a window pops up instructing you to install the developer
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
22 tools.
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
23
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
24 If you don't have the source yet, best is to use git (which you need to
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
25 install first), see http://www.vim.org/git.php
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
26 Or you can download and unpack the Unix tar archive, see
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
27 http://www.vim.org/download.php
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
28
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30 ----------------------------------------------------------------------------
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
31 Build and install the terminal version.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 ----------------------------------------------------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
34 You can compile vim with the standard Unix routine:
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
35 cd vim/src
699
2af8de31a3a8 updated for version 7.0211
vimboss
parents: 674
diff changeset
36 make
7482
52d76b2f56c7 commit https://github.com/vim/vim/commit/d7a08a23bf210147e846c74af570bd219e4903da
Christian Brabandt <cb@256bit.org>
parents: 856
diff changeset
37 make test
52d76b2f56c7 commit https://github.com/vim/vim/commit/d7a08a23bf210147e846c74af570bd219e4903da
Christian Brabandt <cb@256bit.org>
parents: 856
diff changeset
38 sudo make install
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
40 If you get an error "glibtool: command not found" search on stackoverflow for
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
41 mac-osx-where-can-i-download-glibtool.
699
2af8de31a3a8 updated for version 7.0211
vimboss
parents: 674
diff changeset
42
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
43 With Homebrew, run:
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
44
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
45 brew install libtool
699
2af8de31a3a8 updated for version 7.0211
vimboss
parents: 674
diff changeset
46
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
47 To build libtool from source:
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
48
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
49 1. Download the source code from https://www.gnu.org/software/libtool/.
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
50
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
51 2. Run these commands from the root of the source code directory:
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
52
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
53 ./configure --program-prefix=g
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
54 make
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
55 sudo make install
699
2af8de31a3a8 updated for version 7.0211
vimboss
parents: 674
diff changeset
56
674
4b8583e82cb8 updated for version 7.0201
vimboss
parents: 574
diff changeset
57
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
58 ----------------------------------------------------------------------------
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
59 Build and install the GUI version with X-Windows
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
60 ----------------------------------------------------------------------------
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
62 First, install XQuartz, which you can download from https://www.xquartz.org.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
64 To tell configure to use a GUI you can edit the Makefile and uncomment these
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
65 two lines (remove the # at the start of the line):
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
66
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
67 CONF_OPT_GUI = --enable-gui=athena
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
68 CONF_OPT_DARWIN = --disable-darwin
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
70 Do "make distclean" to start with a clean slate.
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
71 Then build as with the terminal version above.
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
72 Instead of "athena" you can try "gtk2" but you probably need to install GTK
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
73 first.
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
74
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
76 ----------------------------------------------------------------------------
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
77 Notes
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
78 ----------------------------------------------------------------------------
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79
24468
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
80 Mac-specific configure options are explained in the Makefile:
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
81 --disable-darwin
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
82 --with-mac-arch
9f41bfdbc6fc Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 23305
diff changeset
83