[Emacs-diffs] Changes to emacs/mac/INSTALL

[YAMAMOTO Mitsuharu]

Index: emacs/mac/INSTALL
diff -c emacs/mac/INSTALL:1.21 emacs/mac/INSTALL:1.22
*** emacs/mac/INSTALL:1.21      Sat Sep 24 11:17:21 2005
--- emacs/mac/INSTALL   Mon Oct 24 00:53:00 2005
***************
*** 1,4 ****
! * BUILDING EMACS ON MAC OS 8/9 AND MAC OS X     -*- outline -*-
  
  Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
  
--- 1,4 ----
! * BUILDING EMACS ON MAC OS Classic AND MAC OS X     -*- outline -*-
  
  Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
  
***************
*** 157,166 ****
  
  For usage of other options, use the --help option.
  
! * BUILDING EMACS ON MAC OS 8/9
  
! 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.
--- 157,167 ----
  
  For usage of other options, use the --help option.
  
! * BUILDING EMACS ON MAC OS Classic
  
! 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,183 ****
  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
  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
  
    make Emacs -f makefile.MPW > Emacs.MakeScript
    Emacs.MakeScript
--- 171,184 ----
  Preferences->Cross Platform->Convert text files to Macintosh format to
  "Never".  Otherwise the compiled Lisp files will be corrupted.
  
! 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
  
    make Emacs -f makefile.MPW > Emacs.MakeScript
    Emacs.MakeScript
***************
*** 186,232 ****
  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.
  
! 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.
  
! 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.
  
  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.
  
  On Mac OS X, installing the emacs files in /usr can cause issues with
! system sofware 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.
  
--- 187,224 ----
  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.
  
! 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.
  
! FIXME: Once built, the Emacs application (Emacs CW or Emacs MPW) can
! be launched where it is created.
  
! 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 - 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.
  
! 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 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.
  
***************
*** 236,240 ****
--- 228,244 ----
  architectures.  In addition, Rosetta doesn't appear to work correctly
  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 address@hidden 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!