Mercurial > emacs
annotate mac/INSTALL @ 74405:8289a04178f1
*** empty log message ***
author | Kim F. Storm <storm@cua.dk> |
---|---|
date | Mon, 04 Dec 2006 12:26:35 +0000 |
parents | e10391aa221e |
children | 3d45362f1d38 f1d13e615070 |
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 |
74141
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
32 The --enable-carbon-app specifies that the Carbon GUI application |
49091
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 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
36 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
|
37 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
|
38 |
49091
4d9ad5d4f2d4
* INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents:
48748
diff
changeset
|
39 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
|
40 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
|
41 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
|
42 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
|
43 -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
|
44 existing info files. |
32752
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
45 |
74141
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
46 After Emacs is installed, you can run a text-only terminal version by |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
47 typing `emacs' from a terminal (make sure your path contains |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
48 /usr/local/bin) or a GUI application by double-clicking on |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
49 /Applications/Emacs.app in the Finder. Even in the terminal version, |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
50 some Carbon-specific functions such as `mac-set-file-creator' are |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
51 still meaningful. |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
52 |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
53 To start Emacs as a GUI application from the terminal, the pathname to |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
54 the 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 |
74141
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
59 correctly. You may want to create an alias to this path to quickly |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
60 access both the terminal and GUI versions. You can specify some |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
61 standard Emacs options when invoking Emacs in this way. |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
62 |
74141
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
63 Emacs on Mac OS X is not configured to use X11 unless either it is |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
64 requested or the use of Carbon is disabled explicitly. So, if you are |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
65 building Emacs to run on X Window System, you need to specify like: |
46776 | 66 |
73823
f0b4afa8b991
Remove descriptions about --without-x. Remove
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
72979
diff
changeset
|
67 ./configure --with-x |
46776 | 68 |
74141
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
69 Note that the Carbon-specific functions mentioned above are not |
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
70 available on the X11-enabled build. |
46776 | 71 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
72 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
|
73 ~/.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
|
74 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
75 ----- |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
76 # 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
|
77 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
|
78 :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
|
79 :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
|
80 :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
|
81 :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
|
82 :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
|
83 :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
|
84 :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
|
85 :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
|
86 :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
|
87 :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
|
88 :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
|
89 ----- |
32752
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
90 |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
49091
diff
changeset
|
91 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
|
92 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
|
93 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
94 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
|
95 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
|
96 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
97 ./configure |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
98 make |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
99 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
|
100 |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
49091
diff
changeset
|
101 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
|
102 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
103 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
|
104 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
|
105 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
|
106 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
107 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
|
108 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
|
109 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
110 ./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
|
111 make |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
112 make install |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
49091
diff
changeset
|
113 |
49091
4d9ad5d4f2d4
* INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents:
48748
diff
changeset
|
114 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
|
115 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
|
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 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
|
118 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
119 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
|
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 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
|
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 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
|
124 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
125 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
|
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 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
|
128 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
|
129 typed |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
130 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
131 export TMPDIR=/tmp |
32752
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
132 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
133 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
|
134 |
48748
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
135 * BUILDING BINARY DISTRIBUTIONS FOR MAC OS X |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
136 |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
137 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
|
138 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
|
139 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
|
140 a disc image containing a installer bundle. By default the installer |
74141
e10391aa221e
Add descriptions about configuration and invocation.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
73823
diff
changeset
|
141 will place the emacs common files in /usr/local/* and the Carbon |
48748
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
142 application in /Applications. Typical usage would be |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
143 |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
144 ./make-package |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
145 |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
146 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
|
147 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
|
148 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
|
149 options to user |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
150 |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
49091
diff
changeset
|
151 --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
|
152 --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
|
153 default is /usr/local. See note below if placing |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
154 in /usr |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
155 --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
|
156 itself. This makes the application trivial to |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
157 uninstall and copy between computers. |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
49091
diff
changeset
|
158 --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
|
159 $prefix/bin/emacs to reduce disk space. Note, this |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
160 option may removed in the future. |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
161 |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
162 |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
163 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
|
164 |
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
|
165 * 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
|
166 |
71820
3b5341ede4ac
More cleanup related to last change.
Kim F. Storm <storm@cua.dk>
parents:
71813
diff
changeset
|
167 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
|
168 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
|
169 |
55853
f900ce9a7062
Updating list of TODOs to remove image support and environment variable problem
Steven Tamm <steventamm@mac.com>
parents:
53580
diff
changeset
|
170 ### 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
|
171 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
|
172 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
|
173 "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
|
174 |
71813
531358390881
Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
68648
diff
changeset
|
175 (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
|
176 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
|
177 |
71813
531358390881
Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
68648
diff
changeset
|
178 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
|
179 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
180 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
|
181 ...: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
|
182 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
|
183 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
184 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
|
185 Emacs.MakeScript |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
186 |
71820
3b5341ede4ac
More cleanup related to last change.
Kim F. Storm <storm@cua.dk>
parents:
71813
diff
changeset
|
187 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
|
188 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
|
189 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
|
190 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
|
191 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
|
192 |
71813
531358390881
Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
68648
diff
changeset
|
193 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
|
194 is created. |
32752
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
195 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
196 * NOTES |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
197 |
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
|
198 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
|
199 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
|
200 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
201 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
|
202 intermediate files. |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
203 |
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
|
204 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
|
205 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
|
206 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
|
207 |
48748
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
208 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
|
209 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
|
210 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
|
211 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
|
212 |
63161
5c72c9c65fb2
Describe support for Intel-based Macintosh
Steven Tamm <steventamm@mac.com>
parents:
60394
diff
changeset
|
213 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
|
214 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
|
215 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
|
216 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
|
217 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
|
218 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
|
219 |
63161
5c72c9c65fb2
Describe support for Intel-based Macintosh
Steven Tamm <steventamm@mac.com>
parents:
60394
diff
changeset
|
220 Enjoy! |