1 |
* BUILDING EMACS ON MAC OS 8/9 AND MAC OS X -*- outline -*- |
* BUILDING EMACS ON MAC OS Classic AND MAC OS X -*- outline -*- |
2 |
|
|
3 |
Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc. |
Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc. |
4 |
|
|
157 |
|
|
158 |
For usage of other options, use the --help option. |
For usage of other options, use the --help option. |
159 |
|
|
160 |
* BUILDING EMACS ON MAC OS 8/9 |
* BUILDING EMACS ON MAC OS Classic |
161 |
|
|
162 |
You can use either Metrowerks CodeWarrior Pro 6 or MPW-GM (Aug. 2001) |
FIXME: You can use either Metrowerks CodeWarrior Pro 6 or MPW-GM |
163 |
to build Emacs. MPW-GM can be downloaded free of charge from Apple. |
(Aug. 2001) to build Emacs. MPW-GM can be downloaded free of charge |
164 |
|
from Apple. |
165 |
|
|
166 |
In either case, you will need MPW-GM to build the make-docfile utility |
In either case, you will need MPW-GM to build the make-docfile utility |
167 |
and to generate the doc string file DOC. |
and to generate the doc string file DOC. |
171 |
Preferences->Cross Platform->Convert text files to Macintosh format to |
Preferences->Cross Platform->Convert text files to Macintosh format to |
172 |
"Never". Otherwise the compiled Lisp files will be corrupted. |
"Never". Otherwise the compiled Lisp files will be corrupted. |
173 |
|
|
174 |
(Optional) A subset of the fonts from the GNU intlfonts-1.2 |
FIXME: (Optional) A subset of the fonts from the GNU intlfonts-1.2 |
175 |
distribution converted to NFNT format can be obtained from |
distribution converted to NFNT format can be obtained from |
176 |
|
|
177 |
ftp://mac-emacs.sourceforge.net/pub/mac-emacs/GNU-fonts.smi.bin |
ftp://mac-emacs.sourceforge.net/pub/mac-emacs/GNU-fonts.smi.bin |
178 |
|
|
179 |
To build Emacs in the MPW Shell, simply set the directory to |
To build Emacs in the MPW Shell, simply set the directory to |
180 |
...:emacs:mac: and build the target Emacs of the make file |
...:emacs:mac: and build the target Emacs of the make file |
181 |
makefile.mpw. I.e., execute the commands |
makefile.MPW. I.e., execute the commands |
182 |
|
|
183 |
make Emacs -f makefile.MPW > Emacs.MakeScript |
make Emacs -f makefile.MPW > Emacs.MakeScript |
184 |
Emacs.MakeScript |
Emacs.MakeScript |
187 |
non-Carbon version can also be created by replacing all the |
non-Carbon version can also be created by replacing all the |
188 |
occurrences of `Emacs' above with `NonCarbon'. Not that the |
occurrences of `Emacs' above with `NonCarbon'. Not that the |
189 |
non-Carbon version does not support some features such as file |
non-Carbon version does not support some features such as file |
190 |
dialogs, drag-and-drop, and unicode menus. |
dialogs, drag-and-drop, and Unicode menus. |
191 |
|
|
192 |
To build Emacs using CodeWarrior, start up the CodeWarrior IDE, choose |
FIXME: To build Emacs using CodeWarrior, start up the CodeWarrior IDE, |
193 |
File->Import Project... and select the file cw6-mcp.xml. When |
choose File->Import Project... and select the file cw6-mcp.xml. When |
194 |
prompted to save the project, navigate to same directory as the file |
prompted to save the project, navigate to same directory as the file |
195 |
cw6-mcp.xml, name the project emacs-cw6.mcp, and save it there. Then |
cw6-mcp.xml, name the project emacs-cw6.mcp, and save it there. Then |
196 |
choose Project->Make. Note that this does not build the DOC file. To |
choose Project->Make. Note that this does not build the DOC file. To |
197 |
do so, use MPW and build the target "Doc" in makefile.MPW. |
do so, use MPW and build the target "Doc" in makefile.MPW. |
198 |
|
|
199 |
Once built, the Emacs application (Emacs CW or Emacs MPW) can be |
FIXME: Once built, the Emacs application (Emacs CW or Emacs MPW) can |
200 |
launched where it is created. |
be launched where it is created. |
201 |
|
|
202 |
To build an optimized version of Emacs in CodeWarrior, change the |
FIXME: To build an optimized version of Emacs in CodeWarrior, change |
203 |
value in the Emacs Settings->Code Generation->Global Optimization |
the value in the Emacs Settings->Code Generation->Global Optimization |
204 |
dialog. To build a version for profiling, check the Profiler |
dialog. To build a version for profiling, check the Profiler |
205 |
Information box in the Emacs Settings->Code Generation->PPC Processor |
Information box in the Emacs Settings->Code Generation->PPC Processor |
206 |
dialog and include the Profiler PPC.Lib library. |
dialog and include the Profiler PPC.Lib library. |
207 |
|
|
208 |
* NOTES |
* NOTES |
209 |
|
|
210 |
Emacs should build and run on a PowerMac running Mac OS 8.6 - 10.4. |
Emacs should build and run on a PowerMac running Mac OS 8.6 - 9.2 (but |
211 |
|
only tested on 9.2.2), and Mac OS X 10.1 - 10.4. |
212 |
|
|
213 |
You will need around 100 MB of disk space for the source files and |
You will need around 100 MB of disk space for the source files and |
214 |
intermediate files. |
intermediate files. |
215 |
|
|
216 |
It will not run on machines running Mac OS 8/9 with more than 512 MB |
Under Mac OS Classic, there is no support for building the LEIM |
217 |
of physical or virtual memory. It does not have this restriction when |
directory. However, it can be built on Mac OS X or another platform |
218 |
it is run under Mac OS X. But the usual 128MB buffer limit of a |
and transferred to the Mac. |
|
32-bit Emacs still exists. |
|
|
|
|
|
Under Mac OS 8/9, there is no support for building the LEIM directory. |
|
|
However, it can be built on Mac OS X or another platform and |
|
|
transferred to the Mac. |
|
|
|
|
|
On Mac OS 8/9, to use the same icon as when Emacs is built on Windows |
|
|
NT, define GNU_ICON in mac/src/Emacs.r. Currently Emacs uses a |
|
|
generic application icon on the Mac OS X. A better looking one is |
|
|
coming soon. |
|
219 |
|
|
220 |
On Mac OS X, installing the emacs files in /usr can cause issues with |
On Mac OS X, installing the emacs files in /usr can cause issues with |
221 |
system sofware updates possibly overwriting the distribution. If this |
system software updates possibly overwriting the distribution. If this |
222 |
is a concern, as it should be in normal binary distributions, please |
is a concern, as it should be in normal binary distributions, please |
223 |
use /usr/local as the prefix for installation. |
use /usr/local as the prefix for installation. |
224 |
|
|
229 |
with PowerPC builds of Emacs; you will have to recompile for Intel. |
with PowerPC builds of Emacs; you will have to recompile for Intel. |
230 |
Therefore, builds of Emacs are architecture specific. |
Therefore, builds of Emacs are architecture specific. |
231 |
|
|
232 |
|
There are some compile-time flags that enable experimental features. |
233 |
|
Please use them at your own risk after reading the corresponding |
234 |
|
threads in the emacs-devel@gnu.org archive. |
235 |
|
|
236 |
|
USE_ATSUI: Enable ATSUI (Apple Type Services for Unicode Imaging) |
237 |
|
support. Available on Mac OS 9/Carbon and Mac OS X. |
238 |
|
http://lists.gnu.org/archive/html/emacs-devel/2005-10/msg00005.html |
239 |
|
|
240 |
|
SELECT_USE_CFSOCKET: Avoid polling in sys_select (in src/mac.c). |
241 |
|
Available on Mac OS X. |
242 |
|
http://lists.gnu.org/archive/html/emacs-devel/2004-12/msg00789.html |
243 |
|
|
244 |
Enjoy! |
Enjoy! |