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