annotate src/INSTALLmac.txt @ 39:410fa1a31baf v7.0023

updated for version 7.0023
author vimboss
date Sun, 19 Dec 2004 22:46:22 +0000
parents 3fc0f57ecb91
children 25a70b1cd2da
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1 INSTALLmac.txt - Installation of Vim on Macintosh
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
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6 An alternate way of building that Benji Fisher uses can be found here:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8 http://macvim.swdev.org/OSX/#Developers
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 ----------------------------------------------------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 Summary
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 ----------------------------------------------------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 1 MacOS X
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 1.1. Carbon interface
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 1.2. X (Athena, GTK, Motif) or plain text.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 2 MacOS Classic
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 2.1. CodeWarrior
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 2.2. MPW
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22 NOTE: The Carbon version can only be compiled properly under
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 MacOS X.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 ----------------------------------------------------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26 1 MacOS X
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 ----------------------------------------------------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 1.0 Considerations
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 Only '/' supported as path separator.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 1.1 Carbon interface (default)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 You can compile vim with the standard Unix routine:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 cd ..
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37 ./configure
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 make; make install
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40 This will create a working Vim.app application bundle in the src
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 directory. You can move this bundle (the Vim.app directory) anywhere
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 you want, for example, /Applications.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 1.2 X-Windows or Plain Text
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 If you do not want the Carbon interface, you must explicitly tell
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 configure to use a different GUI.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 cd ..
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 ./configure --enable-gui=gtk2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 make; make install
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 NOTE: The following GUI options are supported:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 no (for text), motif, athena, nextaw
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 gtk, gtk2, gnome, gnome2,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57 NOTE: You need to first install XFree86 and XDarwin.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 Please visit http://www.XDarwin.org
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
60 ----------------------------------------------------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61 MacOS 9
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62 ----------------------------------------------------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 Both ':' and '/' supported as path separator.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
65
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
66 2.1: Compiling with CodeWarior
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68 1. Expand the resource file:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69 open ../src/os_mac.rsr.hqx to produce ../src/gui_mac.rsrc:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70 % cd vim62/src
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 % open -a StuffIt\ Expander os_mac.rsr.hqx
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
72
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73 2. Expand the project file:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74 - ../src/os_mac.sit.hqx (to produce ../src/vim.mcp)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76 3. Open vim.mcp with CodeWarior
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
77
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78 This is a CodeWarior 9 project file. When using a newer version,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 you need to convert the file. you may also need to change some
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 access path.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82 NOTE: the current project file is old, you need to add a few files:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83 (ex_cmds2.c, fold.c, mbyte.c, move.c)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 4. Select the target PPC, 68k FAT (with/without debugger)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
87 5. Compile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
89 2.2: Compiling with MPW.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91 0. You will need a recent version of the MPW and the Universal Interfaces.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
92 You can get both at:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 ftp://ftp.apple.com/developer/Tool_Chest/Interfaces-Libraries/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94 ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95 For a Carbon version you will need a recent Carbon SDK as well.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96 (When you have an older version already installed you not be able to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 compile a carbon version. Update "CreateMake" which is available at
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98 Apple.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100 1. Expand the resource file:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
101 open ../src/os_mac.rsr.hqx to produce ../src/gui_mac.rsrc:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102 % cd vim62/src
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 % open -a StuffIt\ Expander os_mac.rsr.hqx
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
105 3. Double click on os_make.make, the MPW will now open in the correct
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106 folder and load the CreateVimMake script. Change to the Worksheet
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107 window. Type "os_mac.build" and hit Enter (not Return). A dialog box
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
108 will appear. Select the target you want. (Vim-68k, Vim-ppc, Vim-carbon)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
109
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
110 4. Select "Build" from the menu (or type command-B). Type the program name
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
111 into the dialog box.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
112
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113 ------------------------------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115 OLD FILE: SOME INFO MAY STILL BE USEFUL
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117 NOTE: Users of more recent CodeWarrior version may have to reset the library
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
118 path, and change the mch_delay in os_mac.c so the finalTick is unsigned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
119
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
120 Compilation instructions:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
122 1. Visit the Vim ftp site (see ftp://ftp.vim.org/pub/vim/MIRRORS)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
123 and obtain the following five files:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 unix/vim-X.X-src1.tar.gz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
126 unix/vim-X.X-src2.tar.gz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
127 unix/vim-X.X-rt1.tar.gz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
128 unix/vim-X.X-rt2.tar.gz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129 extra/vim-X.X-extra.tar.gz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
130
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 where X.X is the version number.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
132
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
133 NOTE: the language support is not yet supported
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
134
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
135 2. Expand the archives.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
136
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
137 3. Apply patches if they exist. (Patch files are found in the ftp
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
138 site in the "patches" directory.)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
139
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
140 4. Edit vim-X.X/src/feature.h for your preference. (You can skip
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
141 this, then you will get the default behavior as is documented,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
142 which should be fine for most people.)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
143
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
144 For example, if you want to add the FEAT_MBYTE feature, turn on
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
145 #define FEAT_MBYTE
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
146
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
147 5. Expand the resource file:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
148
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
149 - vim-X.X/src/os_mac.rsr.hqx (to produce vim-X.X/src/gui_mac.rsrc)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
150
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
151 6. If using CodeWarrior, expand the project file:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
152
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
153 - vim-X.X/src/os_mac.sit.hqx (to produce vim-X.X/src/vim.mcp)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
154
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
155 The latter file is the CodeWarrior project file to be used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
156
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
157 7. Launch CodeWarrior by double clicking vim.mcp.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
158
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
159 8. Check additional files if you include non-standard features.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
160
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
161 For example, if you added the MULTI_BYTE feature, check
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
162 Extras/mbyte.c in the project window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
163
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
164 9. Compile and you will obtain binaries: vimPPC, Vim 68k, and/or vimFAT.