| 1 | Copyright (C) 2008-2011 Free Software Foundation, Inc. |
| 2 | See the end of the file for license conditions. |
| 3 | |
| 4 | |
| 5 | Compilation |
| 6 | ----------- |
| 7 | |
| 8 | In the top-level directory, use: |
| 9 | |
| 10 | ./configure --with-ns |
| 11 | |
| 12 | This will compile all the files, but emacs will not be able to be run except |
| 13 | in -nw (terminal) mode. |
| 14 | |
| 15 | In order to run Emacs.app, you must run: |
| 16 | |
| 17 | make install |
| 18 | |
| 19 | This will assemble the app in nextstep/Emacs.app. |
| 20 | |
| 21 | If you pass the --disable-ns-self-contained option to configure, the lisp |
| 22 | files will be installed under whatever 'prefix' is set to (defaults to |
| 23 | /usr/local). The bundle will be smaller, but depend on these resources (may |
| 24 | require 'sudo' for "make install"). |
| 25 | |
| 26 | |
| 27 | Installation |
| 28 | ------------ |
| 29 | |
| 30 | Move nextstep/Emacs.app to any desired install location. |
| 31 | |
| 32 | |
| 33 | Xcode |
| 34 | ----- |
| 35 | |
| 36 | On OS X Emacs can be built under Xcode. You need to run "configure" |
| 37 | as described above first. There are two targets: 'temacs' and 'Emacs.app'. |
| 38 | |
| 39 | 'temacs' will build the undumped emacs executable, and copy it and the |
| 40 | *.o files to the src directory. These steps are necessary so the next target |
| 41 | works. |
| 42 | |
| 43 | 'Emacs.app' uses "Run Script" build phases to assemble the Emacs.app bundle. |
| 44 | It uses the 'ns-app' target in src/Makefile together with the 'install' target |
| 45 | in the top level Makefile. |
| 46 | |
| 47 | The source files under the temacs target must list "pre-crt0" first |
| 48 | and "lastfile" last, so that dumping works. |
| 49 | |
| 50 | (Note, under GNUstep, you CAN'T use ProjectCenter, since PC cannot work |
| 51 | with files outside of its project directory.) |
| 52 | |
| 53 | |
| 54 | Distributions and Universal Binaries |
| 55 | ------------------------------------ |
| 56 | |
| 57 | Building as outlined above will create ordinary binaries running on your |
| 58 | architecture only. To create universal binaries, set CFLAGS to include |
| 59 | "-arch ppc -arch i386". |
| 60 | |
| 61 | \f |
| 62 | This file is part of GNU Emacs. |
| 63 | |
| 64 | GNU Emacs is free software: you can redistribute it and/or modify |
| 65 | it under the terms of the GNU General Public License as published by |
| 66 | the Free Software Foundation, either version 3 of the License, or |
| 67 | (at your option) any later version. |
| 68 | |
| 69 | GNU Emacs is distributed in the hope that it will be useful, |
| 70 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 71 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 72 | GNU General Public License for more details. |
| 73 | |
| 74 | You should have received a copy of the GNU General Public License |
| 75 | along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |