Mercurial > emacs
annotate mac/INSTALL @ 50407:41c0eed9d556
*** empty log message ***
author | Juanma Barranquero <lekktu@gmail.com> |
---|---|
date | Wed, 02 Apr 2003 21:38:43 +0000 |
parents | 23a1cea22d13 |
children | d9dc58d31ffb d7ddb3e565de 68c22ea6027c |
rev | line source |
---|---|
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
1 * BUILDING EMACS ON MAC OS 8/9 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 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
3 Copyright (c) 2001, 2002 Free Software Foundation, Inc. |
36233 | 4 |
5 Permission is granted to anyone to make or distribute verbatim | |
6 copies of this document as received, in any medium, provided that | |
7 the copyright notice and permission notice are preserved, and that | |
8 the distributor grants the recipient permission for further | |
9 redistribution as permitted by this notice. | |
10 | |
11 Permission is granted to distribute modified versions of this | |
12 document, or of portions of it, under the above conditions, | |
13 provided also that they carry prominent notices stating who last | |
14 changed them. | |
15 | |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
16 * 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
|
17 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
18 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
|
19 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
|
20 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
|
21 |
49091
4d9ad5d4f2d4
* INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents:
48748
diff
changeset
|
22 ./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
|
23 make |
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 install |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
25 |
49091
4d9ad5d4f2d4
* INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents:
48748
diff
changeset
|
26 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
|
27 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
|
28 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
|
29 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
|
30 |
4d9ad5d4f2d4
* INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents:
48748
diff
changeset
|
31 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
|
32 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
|
33 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
|
34 |
46917
7f23d458e897
2002-08-15 Andrew Choi <akochoi@shaw.ca>
Andrew Choi <akochoi@shaw.ca>
parents:
46776
diff
changeset
|
35 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
|
36 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
|
37 --without-x' instead of `./configure'. |
7f23d458e897
2002-08-15 Andrew Choi <akochoi@shaw.ca>
Andrew Choi <akochoi@shaw.ca>
parents:
46776
diff
changeset
|
38 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
39 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
|
40 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
|
41 |
49091
4d9ad5d4f2d4
* INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents:
48748
diff
changeset
|
42 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
|
43 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
|
44 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
|
45 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
|
46 -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
|
47 existing info files. |
32752
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
48 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
49 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
|
50 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
|
51 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
|
52 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
|
53 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
|
54 |
49091
4d9ad5d4f2d4
* INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents:
48748
diff
changeset
|
55 /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
|
56 |
641218868c7a
2002-08-27 Andrew Choi <akochoi@shaw.ca>
Andrew Choi <akochoi@shaw.ca>
parents:
46917
diff
changeset
|
57 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
|
58 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
|
59 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
|
60 |
46776 | 61 If you are building Emacs to run on Mac OS X and X Window, you need to |
62 create a directory containing statically-linked X libraries. | |
63 | |
64 sudo mkdir /usr/X11R6/libstatic | |
65 cd /usr/X11R6/libstatic | |
66 sudo ln -s ../lib/lib*.a ../lib/X11 . | |
67 | |
68 Instead of typing `./configure' above, type | |
69 | |
70 ./configure --without-carbon --with-x --x-libraries=/usr/X11R6/libstatic | |
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 |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
141 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
|
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 If you are intending to build a binary distribution for X windows, you |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
163 will probably want to follow the directions above to create static |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
164 X11R6 libraries and run the make-package script like this |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
165 |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
166 ./make-package --with-x -C,--x-libraries=/usr/X11R6/libstatic |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
167 |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
168 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
|
169 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
170 * BUILDING EMACS ON MAC OS 8/9 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
171 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
172 You can use either Metrowerks CodeWarrior Pro 6 or MPW-GM (Aug. 2001) |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
173 to build Emacs. MPW-GM can be downloaded free of charge from Apple. |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
174 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
175 In either case, you will need MPW-GM to build the make-docfile utility |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
176 and to generate the doc string file DOC. |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
177 |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
178 ### IMPORTANT ### You can use StuffIf Expander to decompress and untar |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
179 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
|
180 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
|
181 "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
|
182 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
183 (Optional) A subset of the fonts from the GNU intlfonts-1.2 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
184 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
|
185 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
186 ftp://mac-emacs.sourceforge.net/pub/mac-emacs/GNU-fonts.smi.bin |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
187 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
188 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
|
189 ...:emacs:mac: and build the target Emacs of the make file |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
190 makefile.mpw. I.e., execute the commands |
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 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
|
193 Emacs.MakeScript |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
194 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
195 To build Emacs using CodeWarrior, start up the CodeWarrior IDE, choose |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
196 File->Import Project... and select the file cw6-mcp.xml. When |
32869
59ce5f754d90
2000-10-25 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents:
32752
diff
changeset
|
197 prompted to save the project, navigate to same directory as the file |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
198 cw6-mcp.xml, name the project emacs-cw6.mcp, and save it there. Then |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
199 choose Project->Make. Note that this does not build the DOC file. To |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
200 do so, use MPW and build the target "Doc" in makefile.MPW. |
32752
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
201 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
202 Once built, the Emacs application (Emacs CW or Emacs MPW) can be |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
203 launched where it is created. |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
204 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
205 To build an optimized version of Emacs in CodeWarrior, change the |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
206 value in the Emacs Settings->Code Generation->Global Optimization |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
207 dialog. To build a version for profiling, check the Profiler |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
208 Information box in the Emacs Settings->Code Generation->PPC Processor |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
209 dialog and include the Profiler PPC.Lib library. |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
210 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
211 * NOTES |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
212 |
48748
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
213 Emacs should build and run on a PowerMac running Mac OS 8.6 - 10.2. |
32752
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
214 |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
215 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
|
216 intermediate files. |
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
217 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
218 It will not run on machines running Mac OS 8/9 with more than 256 MB |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
219 of physical or virtual memory. It does not have this restriction when |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
220 it is run under Mac OS X. But the usual 128MB buffer limit of a |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
221 32-bit Emacs still exists. |
32752
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
222 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
223 Under Mac OS 8/9, there is no support for building the LEIM directory. |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
224 However, it can be built on Mac OS X or another platform and |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
225 transferred to the Mac. |
32752
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
226 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
227 On Mac OS 8/9, to use the same icon as when Emacs is built on Windows |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
228 NT, define GNU_ICON in mac/src/Emacs.r. Currently Emacs uses a |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
229 generic application icon on the Mac OS X. A better looking one is |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
230 coming soon. |
32752
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
231 |
48748
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
232 On Mac OS X, installing the emacs files in /usr can cause issues with |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
233 system sofware updates possibly overwriting the distribution. If this |
0f5f21cee53f
Added description of make-package
Steven Tamm <steventamm@mac.com>
parents:
48626
diff
changeset
|
234 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
|
235 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
|
236 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
237 Enjoy! |
32752
923b8d6d8277
Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff
changeset
|
238 |
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
239 Andrew. |
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents:
44729
diff
changeset
|
240 <akochoi@mac.com> |