-* BUILDING EMACS ON MAC OS Classic AND MAC OS X -*- outline -*-
+* BUILDING EMACS ON MAC OS X -*- outline -*-
-Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
+Copyright (C) 2001, 2002, 2003, 2004, 2005,
+ 2006, 2007, 2008 Free Software Foundation, Inc.
+See the end of the file for license conditions.
- Permission is granted to anyone to make or distribute verbatim
- copies of this document as received, in any medium, provided that
- the copyright notice and permission notice are preserved, and that
- the distributor grants the recipient permission for further
- redistribution as permitted by this notice.
-
- Permission is granted to distribute modified versions of this
- document, or of portions of it, under the above conditions,
- provided also that they carry prominent notices stating who last
- changed them.
* BUILDING EMACS ON MAC OS X
must install as root using the sudo command. However, it is not
recommended; see the notes section below for more details.
-The --enable-carbon-app specifies that the carbon GUI application
-should be installed into /Application. If you want it to install in a
-different location, specify --enable-carbon-app=<mydir>
-
-If you have X Window installed on your Mac and you are building Emacs
-to run under Carbon and not X Window, you need to type `./configure
---without-x' instead of `./configure'.
+The --enable-carbon-app specifies that the Carbon GUI application
+should be installed into /Applications. If you want it to install in
+a different location, specify --enable-carbon-app=<mydir>
You can type `make bootstrap' instead of `make' to rebuild everything,
including byte-compiling the Lisp files.
-k' instead of `make' and safely ignore the error messages and use the
existing info files.
-After Emacs is installed, you can run it by typing `emacs -nw' from a
-terminal (make sure your path contains /usr/local/bin) or by
-double-clicking on /Applications/Emacs.app in the Finder. To start
-Emacs as a GUI application from the terminal, the pathname to the
-executable in the bundle, i.e.,
+After Emacs is installed, you can run a text-only terminal version by
+typing `emacs' from a terminal (make sure your path contains
+/usr/local/bin) or a GUI application by double-clicking on
+/Applications/Emacs.app in the Finder. Even in the terminal version,
+some Carbon-specific functions such as `mac-set-file-creator' are
+still meaningful.
+
+To start Emacs as a GUI application from the terminal, the pathname to
+the executable in the bundle, i.e.,
- /Application/Emacs.app/Contents/MacOS/Emacs
+ /Applications/Emacs.app/Contents/MacOS/Emacs
must be typed to the shell to enable Emacs to locate its resources
-correctly. You may want to create a symlink or alias to this path to
-quickly access both the terminal and GUI versions.
+correctly. You may want to create an alias to this path to quickly
+access both the terminal and GUI versions. You can specify some
+standard Emacs options when invoking Emacs in this way.
-If you are building Emacs to run on Mac OS X and X Window,
-instead of typing `./configure' above, type
+Emacs on Mac OS X is not configured to use X11 unless either it is
+requested or the use of Carbon is disabled explicitly. So, if you are
+building Emacs to run on X Window System, you need to specify like:
- ./configure --without-carbon --with-x
+ ./configure --with-x
+Note that the Carbon-specific functions mentioned above are not
+available on the X11-enabled build.
-To use colors in a terminal, put the following lines in the file
-~/.termcap and log in again.
+To use colors in Terminal.app on Mac OS X 10.1, put the following
+lines in the file ~/.termcap and log in again.
-----
# added ANSI color
a script that will greatly simplify the process. It is called
make-package and it is contained in this directory. It will generate
a disc image containing a installer bundle. By default the installer
-will place the emacs common files in /usr/local/* and the carbon
+will place the emacs common files in /usr/local/* and the Carbon
application in /Applications. Typical usage would be
./make-package
For usage of other options, use the --help option.
-* BUILDING EMACS ON MAC OS Classic
-
-FIXME: You can use either Metrowerks CodeWarrior Pro 6 or MPW-GM
-(Aug. 2001) to build Emacs. MPW-GM can be downloaded free of charge
-from Apple.
-
-In either case, you will need MPW-GM to build the make-docfile utility
-and to generate the doc string file DOC.
-
-### IMPORTANT ### You can use StuffIt Expander to decompress and untar
-the distribution. However, you *must* set the radio button in the
-Preferences->Cross Platform->Convert text files to Macintosh format to
-"Never". Otherwise the compiled Lisp files will be corrupted.
-
-FIXME: (Optional) A subset of the fonts from the GNU intlfonts-1.2
-distribution converted to NFNT format can be obtained from
-
- ftp://mac-emacs.sourceforge.net/pub/mac-emacs/GNU-fonts.smi.bin
-
-To build Emacs in the MPW Shell, simply set the directory to
-...:emacs:mac: and build the target Emacs of the make file
-makefile.MPW. I.e., execute the commands
-
- make Emacs -f makefile.MPW > Emacs.MakeScript
- Emacs.MakeScript
-
-The above commands create an executable that uses the Carbon API. The
-non-Carbon version can also be created by replacing all the
-occurrences of `Emacs' above with `NonCarbon'. Not that the
-non-Carbon version does not support some features such as file
-dialogs, drag-and-drop, and Unicode menus.
-
-FIXME: To build Emacs using CodeWarrior, start up the CodeWarrior IDE,
-choose File->Import Project... and select the file cw6-mcp.xml. When
-prompted to save the project, navigate to same directory as the file
-cw6-mcp.xml, name the project emacs-cw6.mcp, and save it there. Then
-choose Project->Make. Note that this does not build the DOC file. To
-do so, use MPW and build the target "Doc" in makefile.MPW.
-
-FIXME: Once built, the Emacs application (Emacs CW or Emacs MPW) can
-be launched where it is created.
-
-FIXME: To build an optimized version of Emacs in CodeWarrior, change
-the value in the Emacs Settings->Code Generation->Global Optimization
-dialog. To build a version for profiling, check the Profiler
-Information box in the Emacs Settings->Code Generation->PPC Processor
-dialog and include the Profiler PPC.Lib library.
+Note: due to the problem "Installing to a directory with non-ASCII
+characters in the name fails" mentioned in etc/PROBLEMS, you may not
+move a self-contained Emacs.app application bundle to a non-ASCII
+directory.
* NOTES
-Emacs should build and run on a PowerMac running Mac OS 8.6 - 9.2 (but
-only tested on 9.2.2), and Mac OS X 10.1 - 10.4.
+Emacs should build and run on a PowerMac running Mac OS X 10.1 - 10.5.
You will need around 100 MB of disk space for the source files and
intermediate files.
-Under Mac OS Classic, there is no support for building the LEIM
-directory. However, it can be built on Mac OS X or another platform
-and transferred to the Mac.
-
On Mac OS X, installing the emacs files in /usr can cause issues with
system software updates possibly overwriting the distribution. If this
is a concern, as it should be in normal binary distributions, please
with PowerPC builds of Emacs; you will have to recompile for Intel.
Therefore, builds of Emacs are architecture specific.
-There are some compile-time flags that enable experimental features.
-Please use them at your own risk after reading the corresponding
-threads in the emacs-devel@gnu.org archive.
+Enjoy!
+
+\f
+This file is part of GNU Emacs.
- USE_ATSUI: Enable ATSUI (Apple Type Services for Unicode Imaging)
- support. Available on Mac OS 9/Carbon and Mac OS X.
- http://lists.gnu.org/archive/html/emacs-devel/2005-10/msg00005.html
+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.
- SELECT_USE_CFSOCKET: Avoid polling in sys_select (in src/mac.c).
- Available on Mac OS X.
- http://lists.gnu.org/archive/html/emacs-devel/2004-12/msg00789.html
+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.
-Enjoy!
+You should have received a copy of the GNU General Public License
+along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.