annotate mac/INSTALL @ 38336:d5f3a4fa3bc5

(ad-make-advised-definition): If the original definition has an interactive form, but is Elp instrumented, use the interactive form of the function called by elp-wrapper.
author Gerd Moellmann <gerd@gnu.org>
date Mon, 09 Jul 2001 13:06:11 +0000
parents c04e66e2c50c
children 12fcb93284db
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
1 * BUILDING EMACS ON THE MAC OS -*- outline -*-
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
2
36233
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
3 Copyright (c) 2001 Free Software Foundation, Inc.
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
4
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
5 Permission is granted to anyone to make or distribute verbatim
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
6 copies of this document as received, in any medium, provided that
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
7 the copyright notice and permission notice are preserved, and that
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
8 the distributor grants the recipient permission for further
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
9 redistribution as permitted by this notice.
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
10
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
11 Permission is granted to distribute modified versions of this
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
12 document, or of portions of it, under the above conditions,
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
13 provided also that they carry prominent notices stating who last
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
14 changed them.
fb3498282d71 Added copyright notice.
Andrew Choi <akochoi@shaw.ca>
parents: 32869
diff changeset
15
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
16 You can use either Metrowerks CodeWarrior Pro 5 or 6 or MPW-GM
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
17 (Aug. 2000) to build Emacs. MPW-GM can be downloaded free of charge
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
18 from Apple at
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
19
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
20 http://developer.apple.com/tools/mpw-tools/
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
21
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
22 You will need MPW-GM to build the make-docfile utility and to generate
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
23 the doc string file DOC.
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
24
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
25 To decompress files, you can use MacGzip from
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
26
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
27 http://persephone.cps.unizar.es/~spd/gzip
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
28
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
29 and to untar them, you can use tar 4.0 from
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
30
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
31 http://hyperarchive.lcs.mit.edu/HyperArchive/Archive/cmp/tar-40b.hqx
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
32
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
33 (Optional) If you wish to fetch files from the Emacs CVS repository
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
34 directly to your Mac, you can use the CVS client MacCVS, which can be
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
35 downloaded from
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
36
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
37 http://www.wincvs.org/
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
38
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
39 (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
40 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
41
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
42 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
43
37738
c04e66e2c50c * src/Emacs.r: Change About box message.
Andrew Choi <akochoi@shaw.ca>
parents: 36233
diff changeset
44 ### IMPORTANT ### If you use StuffIf Expander to decompress and untar
c04e66e2c50c * src/Emacs.r: Change About box message.
Andrew Choi <akochoi@shaw.ca>
parents: 36233
diff changeset
45 the distribution, you *must* set the radio button in the
c04e66e2c50c * src/Emacs.r: Change About box message.
Andrew Choi <akochoi@shaw.ca>
parents: 36233
diff changeset
46 Preferences->Cross Platform->Convert text files to Macintosh format to
c04e66e2c50c * src/Emacs.r: Change About box message.
Andrew Choi <akochoi@shaw.ca>
parents: 36233
diff changeset
47 "Never". Otherwise the compiled Lisp files will be corrupted.
c04e66e2c50c * src/Emacs.r: Change About box message.
Andrew Choi <akochoi@shaw.ca>
parents: 36233
diff changeset
48
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
49 * BUILDING EMACS
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
50
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
51 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
52 ...: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
53 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
54
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
55 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
56 Emacs.MakeScript
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
57
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
58 To build Emacs using CodeWarrior, start up the CodeWarrior IDE, choose
32869
59ce5f754d90 2000-10-25 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 32752
diff changeset
59 File->Import Project... and select the file cw5-mcp.xml or
59ce5f754d90 2000-10-25 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 32752
diff changeset
60 cw6-mcp.xml, depending on which verison of CodeWarrior used. When
59ce5f754d90 2000-10-25 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 32752
diff changeset
61 prompted to save the project, navigate to same directory as the file
59ce5f754d90 2000-10-25 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 32752
diff changeset
62 cw[56]-mcp.xml, name it emacs-cw5.mcp or emacs-cw6.mcp, and save it
59ce5f754d90 2000-10-25 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 32752
diff changeset
63 there. Then choose Project->Make. Note that this does not build the
59ce5f754d90 2000-10-25 Andrew Choi <akochoi@i-cable.com>
Andrew Choi <akochoi@shaw.ca>
parents: 32752
diff changeset
64 DOC file. To do so, use MPW and build the target "Doc" in
32752
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
65 makefile.MPW.
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
66
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
67 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
68 launched where it is created.
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
69
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
70 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
71 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
72 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
73 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
74 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
75
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
76 To build optimized or debugging version of Emacs in MPW, follow the
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
77 comment in makefile.MPW to enable the -opt speed or -sym on option
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
78 (see note below).
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
79
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
80 * NOTES
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
81
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
82 Emacs should build and run on a PowerMac running Mac OS 8.1 - 9.0.
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
83
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
84 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
85 intermediate files.
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
86
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
87 It will not run on machines with more than 256 MB of physical or
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
88 virtual memory.
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
89
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
90 Currently there is no support for building the LEIM directory on the
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
91 Mac. However, it can be built on another platform and transferred to
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
92 the Mac.
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
93
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
94 When Emacs is built with "-opt speed" enabled in makefile.MPW,
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
95 optimization causes the functions reset_buffer_local_variables in
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
96 buffer.c and syms_of_lread in lread.c to crash. Avoid this by
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
97 enclosing them in the following pragmas.
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
98
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
99 #pragma options opt off
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
100
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
101 <function definition...>
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
102
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
103 #pragma options opt reset
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
104
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
105 To use the same icon as when Emacs is built on Windows NT, define
923b8d6d8277 Initial check-in: changes for building Emacs under Mac OS.
Andrew Choi <akochoi@shaw.ca>
parents:
diff changeset
106 GNU_ICON in mac/src/Emacs.r.