annotate mac/INSTALL @ 73823:f0b4afa8b991

Remove descriptions about --without-x. Remove --without-carbon from configure options for X11 build.
author YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
date Wed, 08 Nov 2006 08:03:21 +0000
parents 46aca9ec4c40
children e10391aa221e dbe3f29e61d6
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
66362
1a4e1d124beb Replace `Mac OS 8/9' with `Mac OS Classic'. Add
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 65678
diff changeset
1 * BUILDING EMACS ON MAC OS Classic AND MAC OS X -*- outline -*-
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
2
68648
067115a6e738 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 66362
diff changeset
3 Copyright (C) 2001, 2002, 2003, 2004, 2005,
067115a6e738 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 66362
diff changeset
4 2006 Free Software Foundation, Inc.
36233
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
5
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
6 Permission is granted to anyone to make or distribute verbatim
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
7 copies of this document as received, in any medium, provided that
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
8 the copyright notice and permission notice are preserved, and that
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
9 the distributor grants the recipient permission for further
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
10 redistribution as permitted by this notice.
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
11
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
12 Permission is granted to distribute modified versions of this
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
13 document, or of portions of it, under the above conditions,
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
14 provided also that they carry prominent notices stating who last
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
15 changed them.
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
16
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
17 * BUILDING EMACS ON MAC OS X
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
18
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
19 You should be able to build Emacs on Mac OS X by typing the following
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
20 commands at the top-level directory after the source distribution is
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
21 un-tarred.
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
22
49091
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
23 ./configure --enable-carbon-app
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
24 make
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
25 make install
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
26
49091
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
27 The last step may fail if you do not have permissions to install. If
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
28 you try to install into /usr (with ./configure --prefix=/usr), then you
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
29 must install as root using the sudo command. However, it is not
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
30 recommended; see the notes section below for more details.
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
31
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
32 The --enable-carbon-app specifies that the carbon GUI application
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
33 should be installed into /Application. If you want it to install in a
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
34 different location, specify --enable-carbon-app=<mydir>
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
35
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
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
46 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
47 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
48 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
49 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
50 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
51
49091
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
52 /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
53
641218868c7a 2002-08-27 Andrew Choi <akochoi@shaw.ca>
Andrew Choi <akochoi@shaw.ca>
parents: 46917
diff changeset
54 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
55 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
56 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
57
73823
f0b4afa8b991 Remove descriptions about --without-x. Remove
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 72979
diff changeset
58 If you are building Emacs to run on Mac OS X and X Window System,
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
59 instead of typing `./configure' above, type
46776
16b6134d7193 In src:
Andrew Choi <akochoi@shaw.ca>
parents: 44890
diff changeset
60
73823
f0b4afa8b991 Remove descriptions about --without-x. Remove
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 72979
diff changeset
61 ./configure --with-x
46776
16b6134d7193 In src:
Andrew Choi <akochoi@shaw.ca>
parents: 44890
diff changeset
62
16b6134d7193 In src:
Andrew Choi <akochoi@shaw.ca>
parents: 44890
diff changeset
63
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
64 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
65 ~/.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
66
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
67 -----
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
68 # 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
69 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
70 :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
71 :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
72 :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
73 :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
74 :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
75 :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
76 :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
77 :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
78 :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
79 :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
80 :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
81 -----
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
82
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49091
diff changeset
83 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
84 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
85
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
86 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
87 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
88
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
89 ./configure
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
90 make
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
91 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
92
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49091
diff changeset
93 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
94
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
95 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
96 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
97 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
98
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
99 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
100 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
101
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
102 ./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
103 make
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
104 make install
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49091
diff changeset
105
49091
4d9ad5d4f2d4 * INSTALL: Added documentation about --enable-carbon-app and
Steven Tamm <steventamm@mac.com>
parents: 48748
diff changeset
106 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
107 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
108
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
109 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
110
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 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
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 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
114
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
115 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
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 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
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 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
120 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
121 typed
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 export TMPDIR=/tmp
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
124
44890
01b93e5e53a7 Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
parents: 44729
diff changeset
125 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
126
48748
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
127 * BUILDING BINARY DISTRIBUTIONS FOR MAC OS X
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
128
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
129 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
130 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
131 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
132 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
133 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
134 application in /Applications. Typical usage would be
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
135
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
136 ./make-package
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
137
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
138 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
139 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
140 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
141 options to user
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
142
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49091
diff changeset
143 --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
144 --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
145 default is /usr/local. See note below if placing
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
146 in /usr
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
147 --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
148 itself. This makes the application trivial to
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
149 uninstall and copy between computers.
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49091
diff changeset
150 --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
151 $prefix/bin/emacs to reduce disk space. Note, this
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
152 option may removed in the future.
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
153
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
154
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
155 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
156
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
157 * 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
158
71820
3b5341ede4ac More cleanup related to last change.
Kim F. Storm <storm@cua.dk>
parents: 71813
diff changeset
159 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
160 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
161
55853
f900ce9a7062 Updating list of TODOs to remove image support and environment variable problem
Steven Tamm <steventamm@mac.com>
parents: 53580
diff changeset
162 ### 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
163 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
164 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
165 "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
166
71813
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
167 (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
168 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
169
71813
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
170 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
171
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
172 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
173 ...: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
174 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
175
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
176 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
177 Emacs.MakeScript
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
178
71820
3b5341ede4ac More cleanup related to last change.
Kim F. Storm <storm@cua.dk>
parents: 71813
diff changeset
179 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
180 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
181 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
182 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
183 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
184
71813
531358390881 Remove descriptions about Metrowerks CodeWarrior. Fix URL
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68648
diff changeset
185 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
186 is created.
32752
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 * NOTES
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
189
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
190 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
191 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
192
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
193 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
194 intermediate files.
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
195
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
196 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
197 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
198 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
199
48748
0f5f21cee53f Added description of make-package
Steven Tamm <steventamm@mac.com>
parents: 48626
diff changeset
200 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
201 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
202 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
203 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
204
63161
5c72c9c65fb2 Describe support for Intel-based Macintosh
Steven Tamm <steventamm@mac.com>
parents: 60394
diff changeset
205 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
206 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
207 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
208 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
209 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
210 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
211
63161
5c72c9c65fb2 Describe support for Intel-based Macintosh
Steven Tamm <steventamm@mac.com>
parents: 60394
diff changeset
212 Enjoy!