annotate nextstep/INSTALL @ 97354:0defde3a9c5f

* s/darwin.h (OTHER_FILES): Do not define here, defined in config.in. * Makefile.in (ALL_OBJC_CFLAGS): New variable. (.m.o): Use it. * config.in: Regenerate. * Makefile.in (INSTALLABLES): Add LIB_SRC_EXTRA_INSTALLABLES. Do not special case for NS_IMPL_COCOA. * configure.in (LIB_SRC_EXTRA_INSTALLABLES): New variable. AC_SUBST it. (GNU_OBJC_CFLAGS): Define as a shell variable instead of #define. AC_SUBST it. (OTHER_FILES): Always define for HAVE_NS. (C_SWITCH_X_SYSTEM): Don't define as empty for NS_IMPL_COCOA. * configure: Regenerate.

Copyright (C) 2008 Free Software Foundation, Inc.
See the end of the file for license conditions.


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.

In order to run Emacs.app, you must run:

  make install

This will assemble the app in nextstep/Emacs.app.

If you pass the --disable-ns-self-contained option to configure, the lisp
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
------------

Move nextstep/Emacs.app to any desired install location.


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".


Improve Ctrl-G Handling
-----------------------

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.




This file is part of GNU Emacs.

GNU Emacs is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.