]> code.delx.au - gnu-emacs/blobdiff - nextstep/INSTALL
Merge from emacs-23; up to 2010-06-11T21:26:13Z!lekktu@gmail.com.
[gnu-emacs] / nextstep / INSTALL
index 360c57f18ff595e16dc8b0e229c55c49efef587a..5bc59c6c6fabff358fa451edf528d776966c2f6e 100644 (file)
@@ -1,4 +1,4 @@
-Copyright (C) 2008 Free Software Foundation, Inc.
+Copyright (C) 2008-2011 Free Software Foundation, Inc.
 See the end of the file for license conditions.
 
 
@@ -8,10 +8,6 @@ Compilation
 In the top-level directory, use:
 
   ./configure --with-ns
-  make -j2
-
-Make the -j higher on multi-core systems, usually one higher than number of
-cores is best.
 
 This will compile all the files, but emacs will not be able to be run except
 in -nw (terminal) mode.
@@ -27,15 +23,6 @@ files will be installed under whatever 'prefix' is set to (defaults to
 /usr/local).  The bundle will be smaller, but depend on these resources (may
 require 'sudo' for "make install").
 
-On OS X you can also open Cocoa/Emacs.xcodeproj and build it again there.  You
-may need to set some directories.  (Note, ZeroLink currently does not work
-with Emacs owing to the use of private_extern in the code as well as some
-other, unidentifiable problem.)  Before doing this you must run "make install"
-once as outlined above, to set up the lisp resources.
-
-On GNUstep, you CAN'T use ProjectCenter, since PC cannot work with files
-outside of its project directory.
-
 
 Installation
 ------------
@@ -43,23 +30,34 @@ Installation
 Move nextstep/Emacs.app to any desired install location.
 
 
-Distributions and Universal Binaries
-------------------------------------
+Xcode
+-----
 
-Building as outlined above will create ordinary binaries running on your
-architecture only.  To create universal binaries, set CFLAGS to include
-"-arch ppc -arch i386".
+On OS X Emacs can be built under Xcode.  You need to run "configure"
+as described above first.  There are two targets: 'temacs' and 'Emacs.app'.
 
+'temacs' will build the undumped emacs executable, and copy it and the
+*.o files to the src directory.  These steps are necessary so the next target
+works.
 
-Improve Ctrl-G Handling
------------------------
+'Emacs.app' uses "Run Script" build phases to assemble the Emacs.app bundle.
+It uses the 'ns-app' target in src/Makefile together with the 'install' target
+in the top level Makefile.
 
-To enable a version of the code that handles ctrl-g more responsively in
-certain cases -- but may introduce other glitches -- pass
-"--enable-cocoa-experimental-ctrl-g" to configure.
+The source files under the temacs target must list "pre-crt0" first
+and "lastfile" last, so that dumping works.
 
+(Note, under GNUstep, you CAN'T use ProjectCenter, since PC cannot work
+with files outside of its project directory.)
 
 
+Distributions and Universal Binaries
+------------------------------------
+
+Building as outlined above will create ordinary binaries running on your
+architecture only.  To create universal binaries, set CFLAGS to include
+"-arch ppc -arch i386".
+
 \f
 This file is part of GNU Emacs.