98 lines
2.6 KiB
Plaintext
98 lines
2.6 KiB
Plaintext
Copyright (C) 2008-2024 Free Software Foundation, Inc.
|
||
See the end of the file for license conditions.
|
||
|
||
|
||
Requirements
|
||
------------
|
||
Mac OS X 10.6 or later
|
||
|
||
- or -
|
||
|
||
GNUstep "Startup 0.23" or later
|
||
Tested on GNU/Linux, may work on other systems.
|
||
|
||
|
||
Compilation
|
||
-----------
|
||
|
||
In the top-level directory, use:
|
||
|
||
./configure --with-ns
|
||
|
||
(On macOS, --with-ns is enabled by default.)
|
||
|
||
Then run:
|
||
|
||
make
|
||
|
||
This will compile all the files.
|
||
|
||
In order to run Emacs, you must run:
|
||
|
||
src/emacs
|
||
|
||
In order to install Emacs, you must run:
|
||
|
||
make install
|
||
|
||
This will assemble the app in nextstep/Emacs.app (i.e., the --prefix
|
||
argument has no effect in this case). You can then move the Emacs.app
|
||
bundle to a location of your choice.
|
||
|
||
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").
|
||
|
||
|
||
Targeting different macOS versions
|
||
----------------------------------
|
||
|
||
The Emacs build process automatically enables or disables macOS
|
||
features according to the version of macOS it is being built on. It
|
||
is possible to override this automatic configuration if you are
|
||
targeting a different version of macOS, or wish to build one
|
||
executable that is able to enable or disable features at run-time.
|
||
|
||
To build a version compatible with an older version of macOS use this
|
||
flag:
|
||
|
||
-DMAC_OS_X_VERSION_MIN_REQUIRED=x
|
||
|
||
and to build for a newer version of macOS:
|
||
|
||
-DMAC_OS_X_VERSION_MAX_ALLOWED=x
|
||
|
||
For example, to enable run-time checks for features available between
|
||
macOS 10.6, and 10.12 inclusive:
|
||
|
||
./configure --with-ns CFLAGS="-DMAC_OS_X_VERSION_MIN_REQUIRED=1060 \
|
||
-DMAC_OS_X_VERSION_MAX_ALLOWED=101200 -g3 -O2"
|
||
|
||
The macOS version numbers are formatted as 10x0 for macOS up to 10.10,
|
||
and 10xx00 for macOS 10.10 and above. A full list is provided in
|
||
/usr/include/AvailabilityMacros.h.
|
||
|
||
|
||
Installation
|
||
------------
|
||
|
||
Move nextstep/Emacs.app to any desired install location.
|
||
|
||
|
||
|
||
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 <https://www.gnu.org/licenses/>.
|