Merge from emacs--rel--22
[bpt/emacs.git] / nextstep / INSTALL
1 Copyright (C) 2008 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 make -j2
12
13 Make the -j higher on multi-core systems, usually one higher than number of
14 cores is best.
15
16 This will compile all the files, but emacs will not be able to be run except
17 in -nw (terminal) mode.
18
19 In order to run Emacs.app, you must run:
20
21 make install
22
23 This will assemble the app in nextstep/Emacs.app.
24
25 If you pass the --disable-ns-self-contained option to configure, the lisp
26 files will be installed under whatever 'prefix' is set to (defaults to
27 /usr/local). The bundle will be smaller, but depend on these resources (may
28 require 'sudo' for "make install").
29
30 On OS X you can also open Cocoa/Emacs.xcodeproj and build it again there. You
31 may need to set some directories. (Note, ZeroLink currently does not work
32 with Emacs owing to the use of private_extern in the code as well as some
33 other, unidentifiable problem.) Before doing this you must run "make install"
34 once as outlined above, to set up the lisp resources.
35
36 On GNUstep, you CAN'T use ProjectCenter, since PC cannot work with files
37 outside of its project directory.
38
39
40 Installation
41 ------------
42
43 Move nextstep/Emacs.app to any desired install location.
44
45
46 Distributions and Universal Binaries
47 ------------------------------------
48
49 Building as outlined above will create ordinary binaries running on your
50 architecture only. To create universal binaries, set CFLAGS to include
51 "-arch ppc -arch i386".
52
53
54 Improve Ctrl-G Handling
55 -----------------------
56
57 To enable a version of the code that handles ctrl-g more responsively in
58 certain cases -- but may introduce other glitches -- pass
59 "--enable-cocoa-experimental-ctrl-g" to configure.
60
61
62
63 \f
64 This file is part of GNU Emacs.
65
66 GNU Emacs is free software: you can redistribute it and/or modify
67 it under the terms of the GNU General Public License as published by
68 the Free Software Foundation, either version 3 of the License, or
69 (at your option) any later version.
70
71 GNU Emacs is distributed in the hope that it will be useful,
72 but WITHOUT ANY WARRANTY; without even the implied warranty of
73 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
74 GNU General Public License for more details.
75
76 You should have received a copy of the GNU General Public License
77 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.