/[emacs]/emacs/mac/INSTALL
ViewVC logotype

Diff of /emacs/mac/INSTALL

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.21 by eliz, Sat Sep 24 11:17:21 2005 UTC revision 1.22 by mituharu, Mon Oct 24 00:53:00 2005 UTC
# Line 1  Line 1 
1  * BUILDING EMACS ON MAC OS 8/9 AND MAC OS X     -*- outline -*-  * BUILDING EMACS ON MAC OS Classic AND MAC OS X     -*- outline -*-
2    
3  Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.  Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
4    
# Line 157  options to user Line 157  options to user
157    
158  For usage of other options, use the --help option.  For usage of other options, use the --help option.
159    
160  * BUILDING EMACS ON MAC OS 8/9  * BUILDING EMACS ON MAC OS Classic
161    
162  You can use either Metrowerks CodeWarrior Pro 6 or MPW-GM (Aug. 2001)  FIXME: You can use either Metrowerks CodeWarrior Pro 6 or MPW-GM
163  to build Emacs.  MPW-GM can be downloaded free of charge from Apple.  (Aug. 2001) to build Emacs.  MPW-GM can be downloaded free of charge
164    from Apple.
165    
166  In either case, you will need MPW-GM to build the make-docfile utility  In either case, you will need MPW-GM to build the make-docfile utility
167  and to generate the doc string file DOC.  and to generate the doc string file DOC.
# Line 170  the distribution.  However, you *must* s Line 171  the distribution.  However, you *must* s
171  Preferences->Cross Platform->Convert text files to Macintosh format to  Preferences->Cross Platform->Convert text files to Macintosh format to
172  "Never".  Otherwise the compiled Lisp files will be corrupted.  "Never".  Otherwise the compiled Lisp files will be corrupted.
173    
174  (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
175  distribution converted to NFNT format can be obtained from  distribution converted to NFNT format can be obtained from
176    
177    ftp://mac-emacs.sourceforge.net/pub/mac-emacs/GNU-fonts.smi.bin    ftp://mac-emacs.sourceforge.net/pub/mac-emacs/GNU-fonts.smi.bin
178    
179  To build Emacs in the MPW Shell, simply set the directory to  To build Emacs in the MPW Shell, simply set the directory to
180  ...:emacs:mac: and build the target Emacs of the make file  ...:emacs:mac: and build the target Emacs of the make file
181  makefile.mpw.  I.e., execute the commands  makefile.MPW.  I.e., execute the commands
182    
183    make Emacs -f makefile.MPW > Emacs.MakeScript    make Emacs -f makefile.MPW > Emacs.MakeScript
184    Emacs.MakeScript    Emacs.MakeScript
# Line 186  The above commands create an executable Line 187  The above commands create an executable
187  non-Carbon version can also be created by replacing all the  non-Carbon version can also be created by replacing all the
188  occurrences of `Emacs' above with `NonCarbon'.  Not that the  occurrences of `Emacs' above with `NonCarbon'.  Not that the
189  non-Carbon version does not support some features such as file  non-Carbon version does not support some features such as file
190  dialogs, drag-and-drop, and unicode menus.  dialogs, drag-and-drop, and Unicode menus.
191    
192  To build Emacs using CodeWarrior, start up the CodeWarrior IDE, choose  FIXME: To build Emacs using CodeWarrior, start up the CodeWarrior IDE,
193  File->Import Project...  and select the file cw6-mcp.xml.  When  choose File->Import Project...  and select the file cw6-mcp.xml.  When
194  prompted to save the project, navigate to same directory as the file  prompted to save the project, navigate to same directory as the file
195  cw6-mcp.xml, name the project emacs-cw6.mcp, and save it there.  Then  cw6-mcp.xml, name the project emacs-cw6.mcp, and save it there.  Then
196  choose Project->Make.  Note that this does not build the DOC file.  To  choose Project->Make.  Note that this does not build the DOC file.  To
197  do so, use MPW and build the target "Doc" in makefile.MPW.  do so, use MPW and build the target "Doc" in makefile.MPW.
198    
199  Once built, the Emacs application (Emacs CW or Emacs MPW) can be  FIXME: Once built, the Emacs application (Emacs CW or Emacs MPW) can
200  launched where it is created.  be launched where it is created.
201    
202  To build an optimized version of Emacs in CodeWarrior, change the  FIXME: To build an optimized version of Emacs in CodeWarrior, change
203  value in the Emacs Settings->Code Generation->Global Optimization  the value in the Emacs Settings->Code Generation->Global Optimization
204  dialog.  To build a version for profiling, check the Profiler  dialog.  To build a version for profiling, check the Profiler
205  Information box in the Emacs Settings->Code Generation->PPC Processor  Information box in the Emacs Settings->Code Generation->PPC Processor
206  dialog and include the Profiler PPC.Lib library.  dialog and include the Profiler PPC.Lib library.
207    
208  * NOTES  * NOTES
209    
210  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
211    only tested on 9.2.2), and Mac OS X 10.1 - 10.4.
212    
213  You will need around 100 MB of disk space for the source files and  You will need around 100 MB of disk space for the source files and
214  intermediate files.  intermediate files.
215    
216  It will not run on machines running Mac OS 8/9 with more than 512 MB  Under Mac OS Classic, there is no support for building the LEIM
217  of physical or virtual memory.  It does not have this restriction when  directory.  However, it can be built on Mac OS X or another platform
218  it is run under Mac OS X.  But the usual 128MB buffer limit of a  and transferred to the Mac.
 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.  
219    
220  On Mac OS X, installing the emacs files in /usr can cause issues with  On Mac OS X, installing the emacs files in /usr can cause issues with
221  system sofware updates possibly overwriting the distribution.  If this  system software updates possibly overwriting the distribution.  If this
222  is a concern, as it should be in normal binary distributions, please  is a concern, as it should be in normal binary distributions, please
223  use /usr/local as the prefix for installation.  use /usr/local as the prefix for installation.
224    
# Line 237  architectures.  In addition, Rosetta doe Line 229  architectures.  In addition, Rosetta doe
229  with PowerPC builds of Emacs; you will have to recompile for Intel.  with PowerPC builds of Emacs; you will have to recompile for Intel.
230  Therefore, builds of Emacs are architecture specific.  Therefore, builds of Emacs are architecture specific.
231    
232    There are some compile-time flags that enable experimental features.
233    Please use them at your own risk after reading the corresponding
234    threads in the emacs-devel@gnu.org archive.
235    
236      USE_ATSUI: Enable ATSUI (Apple Type Services for Unicode Imaging)
237      support.  Available on Mac OS 9/Carbon and Mac OS X.
238      http://lists.gnu.org/archive/html/emacs-devel/2005-10/msg00005.html
239    
240      SELECT_USE_CFSOCKET: Avoid polling in sys_select (in src/mac.c).
241      Available on Mac OS X.
242      http://lists.gnu.org/archive/html/emacs-devel/2004-12/msg00789.html
243    
244  Enjoy!  Enjoy!

Legend:
Removed from v.1.21  
changed lines
  Added in v.1.22

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26