view mac/INSTALL @ 96789:e44370b2554f

(ELCFILES): Remove ns-carbon-compat.elc.

+
鐃緒申��申鐃緒申* BUILDING EMACS ON MAC OS X     -*- outline -*-
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Copyright (C) 2001, 2002, 2003, 2004, 2005,
+
鐃緒申��申鐃緒申   2006, 2007, 2008 Free Software Foundation, Inc.
+
鐃緒申��申鐃緒申See the end of the file for license conditions.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申* BUILDING EMACS ON MAC OS X
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申You should be able to build Emacs on Mac OS X by typing the following
+
鐃緒申��申鐃緒申commands at the top-level directory after the source distribution is
+
鐃緒申��申鐃緒申un-tarred.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  ./configure --enable-carbon-app
+
鐃緒申��申鐃緒申  make
+
鐃緒申��申鐃緒申  make install
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申The last step may fail if you do not have permissions to install.  If
+
鐃緒申��申鐃緒申you try to install into /usr (with ./configure --prefix=/usr), then you
+
鐃緒申��申鐃緒申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 /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.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申If you are compiling on Mac OS X versions before 10.2 and have not
+
鐃緒申��申鐃緒申installed the GNU texinfo package on your system, the build will
+
鐃緒申��申鐃緒申complain that makeinfo cannot be found.  Instructions for installing the
+
鐃緒申��申鐃緒申GNU texinfo package are given below.  Alternatively, you can type `make
+
鐃緒申��申鐃緒申-k' instead of `make' and safely ignore the error messages and use the
+
鐃緒申��申鐃緒申existing info files.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申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.,
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  /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 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.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申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 --with-x
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Note that the Carbon-specific functions mentioned above are not
+
鐃緒申��申鐃緒申available on the X11-enabled build.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申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
+
鐃緒申��申鐃緒申vt100|vt100-am|vt100am|dec vt100:\
+
鐃緒申��申鐃緒申    :pa#64:Co#8:Sf=\E[3%dm:Sb=\E[4%dm:op=\E[m:AF=\E[3%dm:AB=\E[4%dm:\
+
鐃緒申��申鐃緒申    :do=^J:co#80:li#24:cl=\E[;H\E[2J:sf=2*\ED:\
+
鐃緒申��申鐃緒申    :le=^H:bs:am:cm=5\E[%i%d;%dH:nd=2\E[C:up=2\E[A:\
+
鐃緒申��申鐃緒申    :ce=3\E[K:cd=50\E[J:so=2\E[7m:se=2\E[m:us=2\E[4m:ue=2\E[m:\
+
鐃緒申��申鐃緒申    :md=2\E[1m:mr=2\E[7m:mb=2\E[5m:me=2\E[m:\
+
鐃緒申��申鐃緒申    :rf=/usr/share/tabset/vt100:\
+
鐃緒申��申鐃緒申    :rs=\E>\E[?3l\E[?4l\E[?5l\E[?7h\E[?8h\E[;r\E[0m\E(B\E)B\E[2J:\
+
鐃緒申��申鐃緒申    :ks=\E[?1h\E=:ke=\E[?1l\E>:\
+
鐃緒申��申鐃緒申    :ku=\EOA:kd=\EOB:kr=\EOC:kl=\EOD:kb=^H:\
+
鐃緒申��申鐃緒申    :ho=\E[H:k1=\EOP:k2=\EOQ:k3=\EOR:k4=\EOS:pt:sr=2*\EM:vt#3:xn:\
+
鐃緒申��申鐃緒申    :sc=\E7:rc=\E8:cs=\E[%i%d;%dr:
+
鐃緒申��申鐃緒申-----
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申To build the `info' files in versions prior to Mac OS X 10.2, you need
+
鐃緒申��申鐃緒申to install the texinfo software.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申To install from source, obtain texinfo-4.2.tar.gz from ftp.gnu.org or
+
鐃緒申��申鐃緒申a mirror.  Un-tar it, enter its directory and type
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  ./configure
+
鐃緒申��申鐃緒申  make
+
鐃緒申��申鐃緒申  make install
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申The last step may need to be performed as root (sudo make install).
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申You may also like to install ispell, which will allow you to use
+
鐃緒申��申鐃緒申ispell and flyspell-mode.  To install ispell from source, you first
+
鐃緒申��申鐃緒申need to install GNU textutils.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申To do so, download textutils-2.0.tar.gz from ftp.gnu.org or a mirror.
+
鐃緒申��申鐃緒申Un-tar it, enter its directory, type
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  ./configure --host=powerpc-apple-bsd
+
鐃緒申��申鐃緒申  make
+
鐃緒申��申鐃緒申  make install
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Again, the last step may need to be performed as root.  Note that if you
+
鐃緒申��申鐃緒申run `make check', the test for `pr' will fail.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Get and un-tar ispell-3.2.06.tar.gz.  Look for it here:
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  http://fmg-www.cs.ucla.edu/geoff/ispell.html
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Go into its directory, type
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  cp local.h.samp local.h
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Add a line `#define TERMLIB ""' to the end of local.h.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Set the environment variable TMPDIR to an existing directory.  For
+
鐃緒申��申鐃緒申example since `/tmp' exists on my machine and I am using `bash', I
+
鐃緒申��申鐃緒申typed
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  export TMPDIR=/tmp
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Run `make' and `make install', the latter as root.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申* BUILDING BINARY DISTRIBUTIONS FOR MAC OS X
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申If you are intending to build a binary distribution of Emacs, there is
+
鐃緒申��申鐃緒申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
+
鐃緒申��申鐃緒申application in /Applications.  Typical usage would be
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申./make-package
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申After running, an compressed disk image of the installer will be placed
+
鐃緒申��申鐃緒申in a file called EmacsInstaller.dmg.  This file can be then distributed
+
鐃緒申��申鐃緒申to whomever would like a binary distribution.  Here are the common
+
鐃緒申��申鐃緒申options to user
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申--with-x         -  Use the X11 GUI instead of the Carbon GUI.
+
鐃緒申��申鐃緒申--prefix=DIR     -  Place the common emacs files in the given DIR.  The
+
鐃緒申��申鐃緒申		    default is /usr/local.  See note below if placing
+
鐃緒申��申鐃緒申		    in /usr
+
鐃緒申��申鐃緒申--self-contained -  Place the common emacs files inside the Emacs.app
+
鐃緒申��申鐃緒申		    itself.  This makes the application trivial to
+
鐃緒申��申鐃緒申		    uninstall and copy between computers.
+
鐃緒申��申鐃緒申--app-symlink    -  Use a symlink inside the Application to the
+
鐃緒申��申鐃緒申	      	    $prefix/bin/emacs to reduce disk space.  Note, this
+
鐃緒申��申鐃緒申		    option may removed in the future.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申For usage of other options, use the --help option.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申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 X 10.1 - 10.5.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申You will need around 100 MB of disk space for the source files and
+
鐃緒申��申鐃緒申intermediate files.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申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
+
鐃緒申��申鐃緒申use /usr/local as the prefix for installation.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Emacs supports both PowerPC and Intel-based Macintoshes.  However,
+
鐃緒申��申鐃緒申due to the unexec process that Emacs uses to dump core, it is not
+
鐃緒申��申鐃緒申possible at this time to generate a universal binary that supports both
+
鐃緒申��申鐃緒申architectures.  In addition, Rosetta doesn't appear to work correctly
+
鐃緒申��申鐃緒申with PowerPC builds of Emacs; you will have to recompile for Intel.
+
鐃緒申��申鐃緒申Therefore, builds of Emacs are architecture specific.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申Enjoy!
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申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/>.