annotate mac/README @ 62103:2d42fd79f829

(toolkit_scroll_bar_interaction): Remove unused variable. (mac_handle_tool_bar_click): Remove unused function and declaration. [USE_TOOLKIT_SCROLL_BARS] (scroll_bar_timer_callback) (install_scroll_bar_timer, set_scroll_bar_timer) (control_part_code_to_scroll_bar_part, construct_scroll_bar_click) (get_control_part_bound, x_scroll_bar_handle_press) (x_scroll_bar_handle_release, x_scroll_bar_handle_drag) (x_set_toolkit_scroll_bar_thumb): New functions and declarations. [USE_TOOLKIT_SCROLL_BARS] (last_scroll_bar_part, scroll_bar_timer) (scroll_bar_timer_event_posted_p): New variables. [USE_TOOLKIT_SCROLL_BARS] (SCROLL_BAR_FIRST_DELAY) (SCROLL_BAR_CONTINUOUS_DELAY): New macros. (x_scroll_bar_create): Set control reference with NewControl. (x_scroll_bar_create) [USE_TOOLKIT_SCROLL_BARS]: Initialize track_top and track_height to nil. (x_scroll_bar_set_handle, x_scroll_bar_note_movement): Put functions in #ifndef USE_TOOLKIT_SCROLL_BARS. (XTset_vertical_scroll_bar): Don't make space between scroll bar and associated window. (XTset_vertical_scroll_bar) [MAC_OSX]: Get scroll bar area width from window config. (XTset_vertical_scroll_bar) [USE_TOOLKIT_SCROLL_BARS]: Set track_top and track_height to nil when scroll bar size is changed. Recalculate them if they are nil. (XTread_socket) [MAC_OSX]: Use control kind to determine if the clicked control is a scroll bar. (XTread_socket) [USE_TOOLKIT_SCROLL_BARS]: Use toolkit scroll bar event handler functions. Don't add modifiers to scroll bar click events. Call scroll bar release handler when window is deactivated. (mac_initialize): Remove unused code for X toolkit. (syms_of_macterm) [!USE_TOOLKIT_SCROLL_BARS]: Initialize Vx_toolkit_scroll_bars to nil.

Emacs for Mac OS 8/9 and Mac OS X

Copyright (c) 2001-4 Free Software Foundation, Inc.

   Permission is granted to anyone to make or distribute verbatim
   copies of this document as received, in any medium, provided that
   the copyright notice and permission notice are preserved, and that
   the distributor grants the recipient permission for further
   redistribution as permitted by this notice.

   Permission is granted to distribute modified versions of this
   document, or of portions of it, under the above conditions,
   provided also that they carry prominent notices stating who last
   changed them.

This directory contains the files needed to build Emacs on the Mac OS
8/9 and Mac OS X.  Many of the major features of the Unix version are
supported: multiple frames, colors, scroll bars, menu bars, use of the
mouse, fontsets, international characters, input methods, and coding
systems.

Mac OS specific support includes document drag-and-drop in the Finder,
transfer of text to and from other applications via the clipboard, and
sending AppleScript commands to other applications from Emacs.

The following are not supported on Mac OS 8/9 : unexec (dump-emacs),
asynchronous subprocesses (start-process), and networking
(open-network-stream).  These features work fine on Mac OS X.

There is basic support for synchronous subprocesses (call-process) on
Mac OS 8/9 although Unix commands that are used will need to be
ported.

Metrowerks CodeWarrior Pro 6 or MPW-GM (August 2001) can be used to
build Emacs on the Mac OS 8/9.  On Mac OS X, Emacs can be built using
the Developer Tools.  See the INSTALL file in this directory for
instructions on building Emacs.

Binary distributions will be available in

  ftp://ftp.gnu.org/gnu/mac/emacs/

Read the Mac OS section of the on-line help to find out about how to
use Emacs on the Mac.

A number of things do not work yet:

+ Emacs does not respond correctly to C-g under certain circumstances.  
  Sending the Emacs process a SIGINT externally will cause it 
  to interrupt.  This is due to the architecture of OSX's 
  Window Manager.

+ Support for certain image types (such as XPM) is not as extensive as 
  on other plaforms. 

If your Mac is connected to the Internet, report bugs by typing `M-x
report-emacs-bug' or by choosing the entry `Send Bug Report...'  in
the `Help' menu.  This will send the bug report to the address
[e-mail].

Steven
<[e-mail]>