diff mac/INSTALL @ 66362:1a4e1d124beb

Replace `Mac OS 8/9' with `Mac OS Classic'. Add `FIXME' to descriptions about Metrowerks CodeWarrior. Remove obsolete description about 512MB limit and icon on Mac OS Classic. Add description about flags for experimental features.

--- a/mac/INSTALL	Mon Oct 24 00:10:02 2005 +0000
+++ b/mac/INSTALL	Mon Oct 24 00:53:00 2005 +0000
@@ -1,4 +1,4 @@
-* BUILDING EMACS ON MAC OS 8/9 AND MAC OS X     -*- outline -*-
+* BUILDING EMACS ON MAC OS Classic AND MAC OS X     -*- outline -*-
 
 Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
 
@@ -157,10 +157,11 @@
 
 For usage of other options, use the --help option.
 
-* BUILDING EMACS ON MAC OS 8/9
+* BUILDING EMACS ON MAC OS Classic
 
-You can use either Metrowerks CodeWarrior Pro 6 or MPW-GM (Aug. 2001)
-to build Emacs.  MPW-GM can be downloaded free of charge from Apple.
+FIXME: You can use either Metrowerks CodeWarrior Pro 6 or MPW-GM
+(Aug. 2001) to build Emacs.  MPW-GM can be downloaded free of charge
+from Apple.
 
 In either case, you will need MPW-GM to build the make-docfile utility
 and to generate the doc string file DOC.
@@ -170,14 +171,14 @@
 Preferences->Cross Platform->Convert text files to Macintosh format to
 "Never".  Otherwise the compiled Lisp files will be corrupted.
 
-(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
 distribution converted to NFNT format can be obtained from
 
   ftp://mac-emacs.sourceforge.net/pub/mac-emacs/GNU-fonts.smi.bin
 
 To build Emacs in the MPW Shell, simply set the directory to
 ...:emacs:mac: and build the target Emacs of the make file
-makefile.mpw.  I.e., execute the commands
+makefile.MPW.  I.e., execute the commands
 
   make Emacs -f makefile.MPW > Emacs.MakeScript
   Emacs.MakeScript
@@ -186,47 +187,38 @@
 non-Carbon version can also be created by replacing all the
 occurrences of `Emacs' above with `NonCarbon'.  Not that the
 non-Carbon version does not support some features such as file
-dialogs, drag-and-drop, and unicode menus.
+dialogs, drag-and-drop, and Unicode menus.
 
-To build Emacs using CodeWarrior, start up the CodeWarrior IDE, choose
-File->Import Project...  and select the file cw6-mcp.xml.  When
+FIXME: To build Emacs using CodeWarrior, start up the CodeWarrior IDE,
+choose File->Import Project...  and select the file cw6-mcp.xml.  When
 prompted to save the project, navigate to same directory as the file
 cw6-mcp.xml, name the project emacs-cw6.mcp, and save it there.  Then
 choose Project->Make.  Note that this does not build the DOC file.  To
 do so, use MPW and build the target "Doc" in makefile.MPW.
 
-Once built, the Emacs application (Emacs CW or Emacs MPW) can be
-launched where it is created.
+FIXME: Once built, the Emacs application (Emacs CW or Emacs MPW) can
+be launched where it is created.
 
-To build an optimized version of Emacs in CodeWarrior, change the
-value in the Emacs Settings->Code Generation->Global Optimization
+FIXME: To build an optimized version of Emacs in CodeWarrior, change
+the value in the Emacs Settings->Code Generation->Global Optimization
 dialog.  To build a version for profiling, check the Profiler
 Information box in the Emacs Settings->Code Generation->PPC Processor
 dialog and include the Profiler PPC.Lib library.
 
 * NOTES
 
-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
+only tested on 9.2.2), and Mac OS X 10.1 - 10.4.
 
 You will need around 100 MB of disk space for the source files and
 intermediate files.
 
-It will not run on machines running Mac OS 8/9 with more than 512 MB
-of physical or virtual memory.  It does not have this restriction when
-it is run under Mac OS X.  But the usual 128MB buffer limit of a
-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.
+Under Mac OS Classic, 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 X, installing the emacs files in /usr can cause issues with
-system sofware updates possibly overwriting the distribution.  If this
+system software updates possibly overwriting the distribution.  If this
 is a concern, as it should be in normal binary distributions, please
 use /usr/local as the prefix for installation.
 
@@ -237,4 +229,16 @@
 with PowerPC builds of Emacs; you will have to recompile for Intel.
 Therefore, builds of Emacs are architecture specific.
 
+There are some compile-time flags that enable experimental features.
+Please use them at your own risk after reading the corresponding
+threads in the [e-mail] archive.
+
+  USE_ATSUI: Enable ATSUI (Apple Type Services for Unicode Imaging)
+  support.  Available on Mac OS 9/Carbon and Mac OS X.
+  http://lists.gnu.org/archive/html/emacs-devel/2005-10/msg00005.html
+
+  SELECT_USE_CFSOCKET: Avoid polling in sys_select (in src/mac.c).
+  Available on Mac OS X.
+  http://lists.gnu.org/archive/html/emacs-devel/2004-12/msg00789.html
+
 Enjoy!