nextstep/INSTALL

   1 Copyright (C) 2008, 2009 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/>.