mac/README

   1 Emacs for Mac OS 8/9 and Mac OS X
   2
   3 Copyright (C) 2001, 2002, 2003, 2004, 2005 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 Read the Mac OS section of the on-line help to find out about how to
  40 use Emacs on the Mac.
  41
  42 A number of things do not work yet:
  43
  44 + Emacs does not respond correctly to C-g under certain circumstances.
  45   Sending the Emacs process a SIGINT externally will cause it
  46   to interrupt.  This is due to the architecture of OSX's
  47   Window Manager.
  48
  49 + Support for certain image types (such as XPM) is not as extensive as
  50   on other plaforms.
  51
  52 + Incorporate Apple's wrappers to be able to create a universal
  53   binary that unexecs on first run for the given architecture.
  54
  55 If your Mac is connected to the Internet, report bugs by typing `M-x
  56 report-emacs-bug' or by choosing the entry `Send Bug Report...'  in
  57 the `Help' menu.  This will send the bug report to the address
  58 emacs-pretest-bug@gnu.org.
  59
  60 Steven
  61 <steven.tamm@mac.com>