Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
[bpt/emacs.git] / mac / README
1 Emacs for Mac OS 8/9 and Mac OS X
2
3 Copyright (c) 2001, 2002 Free Software Foundation, Inc.
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
16 This directory contains the files needed to build Emacs on the Mac OS
17 8/9 and Mac OS X. Many of the major features of the Unix version are
18 supported: multiple frames, colors, scroll bars, menu bars, use of the
19 mouse, fontsets, international characters, input methods, and coding
20 systems.
21
22 Mac OS specific support includes document drag-and-drop in the Finder,
23 transfer of text to and from other applications via the clipboard, and
24 sending AppleScript commands to other applications from Emacs.
25
26 The following are not supported on Mac OS 8/9 : unexec (dump-emacs),
27 asynchronous subprocesses (start-process), and networking
28 (open-network-stream). These features work fine on Mac OS X.
29
30 There is basic support for synchronous subprocesses (call-process) on
31 Mac OS 8/9 although Unix commands that are used will need to be
32 ported.
33
34 Metrowerks CodeWarrior Pro 6 or MPW-GM (August 2001) can be used to
35 build Emacs on the Mac OS 8/9. On Mac OS X, Emacs can be built using
36 the Developer Tools. See the INSTALL file in this directory for
37 instructions on building Emacs.
38
39 Binary distributions will be available in
40
41 ftp://ftp.gnu.org/gnu/mac/emacs/
42
43 Read the Mac OS section of the on-line help to find out about how to
44 use Emacs on the Mac.
45
46 A number of things do not work yet:
47
48 + On Mac OS X, environment variables are not set up correctly when
49 Emacs is started from the Finder.
50
51 + Emacs does not respond correctly to C-g when it is not reading
52 input.
53
54 + No image support yet.
55
56 + There is no mouse-2 and mouse-3 emulation yet.
57
58 If your Mac is connected to the Internet, report bugs by typing `M-x
59 report-emacs-bug' or by choosing the entry `Send Bug Report...' in
60 the `Help' menu. This will send the bug report to the address
61 emacs-pretest-bug@gnu.org.
62
63 Andrew.
64 <akochoi@mac.com>