annotate mac/INSTALL @ 72953:4df4a8300599

(SELECT_USE_CFSOCKET) [MAC_OSX]: Set default to 1. [MAC_OSX] (sys_select) [SELECT_USE_CFSOCKET]: Fix pointer type.
author YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
date Mon, 18 Sep 2006 07:32:36 +0000
parents 3b5341ede4ac
children 46aca9ec4c40 8a8e69664178
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
66362
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
1 * BUILDING EMACS ON MAC OS Classic AND MAC OS X -*- outline -*-
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
2
68648
067115a6e738 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 66362
diff changeset
3 Copyright (C) 2001, 2002, 2003, 2004, 2005,
067115a6e738 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 66362
diff changeset
4 2006 Free Software Foundation, Inc.
36233
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
5
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
6 Permission is granted to anyone to make or distribute verbatim
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
7 copies of this document as received, in any medium, provided that
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
8 the copyright notice and permission notice are preserved, and that
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
9 the distributor grants the recipient permission for further
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
10 redistribution as permitted by this notice.
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
11
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
12 Permission is granted to distribute modified versions of this
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
13 document, or of portions of it, under the above conditions,
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
14 provided also that they carry prominent notices stating who last
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
15 changed them.
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
16
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
17 * BUILDING EMACS ON MAC OS X
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
18
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
19 You should be able to build Emacs on Mac OS X by typing the following
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
20 commands at the top-level directory after the source distribution is
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
21 un-tarred.
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
22
49091
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
23 ./configure --enable-carbon-app
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
24 make
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
25 make install
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
26
49091
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
27 The last step may fail if you do not have permissions to install. If
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
28 you try to install into /usr (with ./configure --prefix=/usr), then you
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
29 must install as root using the sudo command. However, it is not
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
30 recommended; see the notes section below for more details.
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
31
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
32 The --enable-carbon-app specifies that the carbon GUI application
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
33 should be installed into /Application. If you want it to install in a
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
34 different location, specify --enable-carbon-app=<mydir>
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
35
46917
7f23d458e897 2002-08-15 Andrew Choi <akochoi@shaw.ca>
Andrew Choi <akochoi@shaw.ca>
parents: 46776
diff changeset
36 If you have X Window installed on your Mac and you are building Emacs
7f23d458e897 2002-08-15 Andrew Choi <akochoi@shaw.ca>
Andrew Choi <akochoi@shaw.ca>
parents: 46776
diff changeset
37 to run under Carbon and not X Window, you need to type `./configure
7f23d458e897 2002-08-15 Andrew Choi <akochoi@shaw.ca>
Andrew Choi <akochoi@shaw.ca>
parents: 46776
diff changeset
38 --without-x' instead of `./configure'.
7f23d458e897 2002-08-15 Andrew Choi <akochoi@shaw.ca>
Andrew Choi <akochoi@shaw.ca>
parents: 46776
diff changeset
39
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
40 You can type `make bootstrap' instead of `make' to rebuild everything,
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
41 including byte-compiling the Lisp files.
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
42
49091
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
43 If you are compiling on Mac OS X versions before 10.2 and have not
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
44 installed the GNU texinfo package on your system, the build will
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
45 complain that makeinfo cannot be found. Instructions for installing the
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
46 GNU texinfo package are given below. Alternatively, you can type `make
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
47 -k' instead of `make' and safely ignore the error messages and use the
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
48 existing info files.
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
49
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
50 After Emacs is installed, you can run it by typing `emacs -nw' from a
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
51 terminal (make sure your path contains /usr/local/bin) or by
49091
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
52 double-clicking on /Applications/Emacs.app in the Finder. To start
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
53 Emacs as a GUI application from the terminal, the pathname to the
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
54 executable in the bundle, i.e.,
47072
641218868c7a 2002-08-27 Andrew Choi <akochoi@shaw.ca>
Andrew Choi <akochoi@shaw.ca>
parents: 46917
diff changeset
55
49091
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
56 /Application/Emacs.app/Contents/MacOS/Emacs
47072
641218868c7a 2002-08-27 Andrew Choi <akochoi@shaw.ca>
Andrew Choi <akochoi@shaw.ca>
parents: 46917
diff changeset
57
641218868c7a 2002-08-27 Andrew Choi <akochoi@shaw.ca>
Andrew Choi <akochoi@shaw.ca>
parents: 46917
diff changeset
58 must be typed to the shell to enable Emacs to locate its resources
49091
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
59 correctly. You may want to create a symlink or alias to this path to
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
60 quickly access both the terminal and GUI versions.
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
61
52961
d9dc58d31ffb These are Nozomu Ando's changes to build Emacs to run under X Window
Andrew Choi <akochoi@shaw.ca>
parents: 49600
diff changeset
62 If you are building Emacs to run on Mac OS X and X Window,
d9dc58d31ffb These are Nozomu Ando's changes to build Emacs to run under X Window
Andrew Choi <akochoi@shaw.ca>
parents: 49600
diff changeset
63 instead of typing `./configure' above, type
46776
16b6134d7193 In src:
Andrew Choi <akochoi@shaw.ca>
parents: 44890
diff changeset
64
52961
d9dc58d31ffb These are Nozomu Ando's changes to build Emacs to run under X Window
Andrew Choi <akochoi@shaw.ca>
parents: 49600
diff changeset
65 ./configure --without-carbon --with-x
46776
16b6134d7193 In src:
Andrew Choi <akochoi@shaw.ca>
parents: 44890
diff changeset
66
16b6134d7193 In src:
Andrew Choi <akochoi@shaw.ca>
parents: 44890
diff changeset
67
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
68 To use colors in a terminal, put the following lines in the file
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
69 ~/.termcap and log in again.
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
70
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
71 -----
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
72 # added ANSI color
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
73 vt100|vt100-am|vt100am|dec vt100:\
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
74 :pa#64:Co#8:Sf=\E[3%dm:Sb=\E[4%dm:op=\E[m:AF=\E[3%dm:AB=\E[4%dm:\
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
75 :do=^J:co#80:li#24:cl=\E[;H\E[2J:sf=2*\ED:\
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
76 :le=^H:bs:am:cm=5\E[%i%d;%dH:nd=2\E[C:up=2\E[A:\
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
77 :ce=3\E[K:cd=50\E[J:so=2\E[7m:se=2\E[m:us=2\E[4m:ue=2\E[m:\
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
78 :md=2\E[1m:mr=2\E[7m:mb=2\E[5m:me=2\E[m:\
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
79 :rf=/usr/share/tabset/vt100:\
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
80 :rs=\E>\E[?3l\E[?4l\E[?5l\E[?7h\E[?8h\E[;r\E[0m\E(B\E)B\E[2J:\
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
81 :ks=\E[?1h\E=:ke=\E[?1l\E>:\
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
82 :ku=\EOA:kd=\EOB:kr=\EOC:kl=\EOD:kb=^H:\
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
83 :ho=\E[H:k1=\EOP:k2=\EOQ:k3=\EOR:k4=\EOS:pt:sr=2*\EM:vt#3:xn:\
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
84 :sc=\E7:rc=\E8:cs=\E[%i%d;%dr:
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
85 -----
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
86
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49091
diff changeset
87 To build the `info' files in versions prior to Mac OS X 10.2, you need
49091
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
88 to install the texinfo software.
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
89
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
90 To install from source, obtain texinfo-4.2.tar.gz from ftp.gnu.org or
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
91 a mirror. Un-tar it, enter its directory and type
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
92
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
93 ./configure
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
94 make
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
95 make install
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
96
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49091
diff changeset
97 The last step may need to be performed as root (sudo make install).
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
98
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
99 You may also like to install ispell, which will allow you to use
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
100 ispell and flyspell-mode. To install ispell from source, you first
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
101 need to install GNU textutils.
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
102
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
103 To do so, download textutils-2.0.tar.gz from ftp.gnu.org or a mirror.
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
104 Un-tar it, enter its directory, type
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
105
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
106 ./configure --host=powerpc-apple-bsd
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
107 make
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
108 make install
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49091
diff changeset
109
49091
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
110 Again, the last step may need to be performed as root. Note that if you
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
111 run `make check', the test for `pr' will fail.
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
112
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
113 Get and un-tar ispell-3.2.06.tar.gz. Look for it here:
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
114
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
115 http://fmg-www.cs.ucla.edu/geoff/ispell.html
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
116
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
117 Go into its directory, type
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
118
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
119 cp local.h.samp local.h
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
120
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
121 Add a line `#define TERMLIB ""' to the end of local.h.
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
122
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
123 Set the environment variable TMPDIR to an existing directory. For
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
124 example since `/tmp' exists on my machine and I am using `bash', I
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
125 typed
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
126
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
127 export TMPDIR=/tmp
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
128
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
129 Run `make' and `make install', the latter as root.
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
130
48748
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
131 * BUILDING BINARY DISTRIBUTIONS FOR MAC OS X
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
132
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
133 If you are intending to build a binary distribution of Emacs, there is
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
134 a script that will greatly simplify the process. It is called
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
135 make-package and it is contained in this directory. It will generate
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
136 a disc image containing a installer bundle. By default the installer
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
137 will place the emacs common files in /usr/local/* and the carbon
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
138 application in /Applications. Typical usage would be
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
139
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
140 ./make-package
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
141
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
142 After running, an compressed disk image of the installer will be placed
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
143 in a file called EmacsInstaller.dmg. This file can be then distributed
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
144 to whomever would like a binary distribution. Here are the common
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
145 options to user
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
146
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49091
diff changeset
147 --with-x - Use the X11 GUI instead of the Carbon GUI.
48748
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
148 --prefix=DIR - Place the common emacs files in the given DIR. The
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
149 default is /usr/local. See note below if placing
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
150 in /usr
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
151 --self-contained - Place the common emacs files inside the Emacs.app
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
152 itself. This makes the application trivial to
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
153 uninstall and copy between computers.
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49091
diff changeset
154 --app-symlink - Use a symlink inside the Application to the
48748
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
155 $prefix/bin/emacs to reduce disk space. Note, this
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
156 option may removed in the future.
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
157
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
158
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
159 For usage of other options, use the --help option.
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
160
66362
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
161 * BUILDING EMACS ON MAC OS Classic
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
162
71820
3b5341ede4ac More cleanup related to last change.
Kim F. Storm <storm@cua.dk>
parents: 71813
diff changeset
163 You can use MPW-GM (Aug. 2001) to build Emacs. MPW-GM can be
71813
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
164 downloaded free of charge from Apple.
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
165
55853
f900ce9a7062 Updating list of TODOs to remove image support and environment variable problem
Steven Tamm <steventamm@mac.com>
parents: 53580
diff changeset
166 ### IMPORTANT ### You can use StuffIt Expander to decompress and untar
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
167 the distribution. However, you *must* set the radio button in the
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
168 Preferences->Cross Platform->Convert text files to Macintosh format to
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
169 "Never". Otherwise the compiled Lisp files will be corrupted.
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
170
71813
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
171 (Optional) A subset of the fonts from the GNU intlfonts-1.2
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
172 distribution converted to NFNT format can be obtained from
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
173
71813
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
174 http://members.shaw.ca/akochoi-emacs/stories/Resources/GNU-Fonts.smi.bin
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
175
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
176 To build Emacs in the MPW Shell, simply set the directory to
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
177 ...:emacs:mac: and build the target Emacs of the make file
66362
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
178 makefile.MPW. I.e., execute the commands
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
179
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
180 make Emacs -f makefile.MPW > Emacs.MakeScript
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
181 Emacs.MakeScript
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
182
71820
3b5341ede4ac More cleanup related to last change.
Kim F. Storm <storm@cua.dk>
parents: 71813
diff changeset
183 The above commands create an executable that uses the Carbon API.
3b5341ede4ac More cleanup related to last change.
Kim F. Storm <storm@cua.dk>
parents: 71813
diff changeset
184 The non-Carbon version can also be created by replacing all the
60394
ba6caa525be2 Mention new target `NonCarbon'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 55853
diff changeset
185 occurrences of `Emacs' above with `NonCarbon'. Not that the
ba6caa525be2 Mention new target `NonCarbon'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 55853
diff changeset
186 non-Carbon version does not support some features such as file
66362
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
187 dialogs, drag-and-drop, and Unicode menus.
60394
ba6caa525be2 Mention new target `NonCarbon'.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 55853
diff changeset
188
71813
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
189 Once built, the Emacs application (Emacs MPW) can be launched where it
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
190 is created.
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
191
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
192 * NOTES
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
193
66362
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
194 Emacs should build and run on a PowerMac running Mac OS 8.6 - 9.2 (but
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
195 only tested on 9.2.2), and Mac OS X 10.1 - 10.4.
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
196
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
197 You will need around 100 MB of disk space for the source files and
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
198 intermediate files.
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
199
66362
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
200 Under Mac OS Classic, there is no support for building the LEIM
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
201 directory. However, it can be built on Mac OS X or another platform
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
202 and transferred to the Mac.
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
203
48748
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
204 On Mac OS X, installing the emacs files in /usr can cause issues with
66362
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
205 system software updates possibly overwriting the distribution. If this
48748
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
206 is a concern, as it should be in normal binary distributions, please
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
207 use /usr/local as the prefix for installation.
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
208
63161
5c72c9c65fb2 Describe support for Intel-based Macintosh
Steven Tamm <steventamm@mac.com>
parents: 60394
diff changeset
209 Emacs supports both PowerPC and Intel-based Macintoshes. However,
5c72c9c65fb2 Describe support for Intel-based Macintosh
Steven Tamm <steventamm@mac.com>
parents: 60394
diff changeset
210 due to the unexec process that Emacs uses to dump core, it is not
5c72c9c65fb2 Describe support for Intel-based Macintosh
Steven Tamm <steventamm@mac.com>
parents: 60394
diff changeset
211 possible at this time to generate a universal binary that supports both
5c72c9c65fb2 Describe support for Intel-based Macintosh
Steven Tamm <steventamm@mac.com>
parents: 60394
diff changeset
212 architectures. In addition, Rosetta doesn't appear to work correctly
5c72c9c65fb2 Describe support for Intel-based Macintosh
Steven Tamm <steventamm@mac.com>
parents: 60394
diff changeset
213 with PowerPC builds of Emacs; you will have to recompile for Intel.
5c72c9c65fb2 Describe support for Intel-based Macintosh
Steven Tamm <steventamm@mac.com>
parents: 60394
diff changeset
214 Therefore, builds of Emacs are architecture specific.
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
215
66362
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
216 There are some compile-time flags that enable experimental features.
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
217 Please use them at your own risk after reading the corresponding
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
218 threads in the emacs-devel@gnu.org archive.
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
219
71813
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
220 SELECT_USE_CFSOCKET (on Mac OS X): Avoid polling in sys_select (in
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
221 src/mac.c).
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
222 http://lists.gnu.org/archive/html/emacs-devel/2004-12/msg00789.html
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
223
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
224 USE_ATSUI (on Mac OS 9/Carbon): Enable ATSUI (Apple Type Services
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
225 for Unicode Imaging) support.
66362
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
226 http://lists.gnu.org/archive/html/emacs-devel/2005-10/msg00005.html
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
227
63161
5c72c9c65fb2 Describe support for Intel-based Macintosh
Steven Tamm <steventamm@mac.com>
parents: 60394
diff changeset
228 Enjoy!