Mercurial > emacs
annotate mac/INSTALL @ 71820:3b5341ede4ac
More cleanup related to last change.
author | Kim F. Storm <storm@cua.dk> |
---|---|
date | Wed, 12 Jul 2006 13:01:23 +0000 |
parents | 531358390881 |
children | 46aca9ec4c40 8a8e69664178 |
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 | 5 |
6 Permission is granted to anyone to make or distribute verbatim | |
7 copies of this document as received, in any medium, provided that | |
8 the copyright notice and permission notice are preserved, and that | |
9 the distributor grants the recipient permission for further | |
10 redistribution as permitted by this notice. | |
11 | |
12 Permission is granted to distribute modified versions of this | |
13 document, or of portions of it, under the above conditions, | |
14 provided also that they carry prominent notices stating who last | |
15 changed them. | |
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 | 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 | 66 |
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! |