19 |
commands at the top-level directory after the source distribution is |
commands at the top-level directory after the source distribution is |
20 |
un-tarred. |
un-tarred. |
21 |
|
|
22 |
./configure |
./configure --enable-carbon-app |
23 |
make |
make |
24 |
make install |
make install |
25 |
|
|
26 |
The last step must be performed as root. |
The last step may fail if you do not have permissions to install. If |
27 |
|
you try to install into /usr (with ./configure --prefix=/usr), then you |
28 |
|
must install as root using the sudo command. However, it is not |
29 |
|
recommended; see the notes section below for more details. |
30 |
|
|
31 |
|
The --enable-carbon-app specifies that the carbon GUI application |
32 |
|
should be installed into /Application. If you want it to install in a |
33 |
|
different location, specify --enable-carbon-app=<mydir> |
34 |
|
|
35 |
If you have X Window installed, you need to type `./configure |
If you have X Window installed on your Mac and you are building Emacs |
36 |
|
to run under Carbon and not X Window, you need to type `./configure |
37 |
--without-x' instead of `./configure'. |
--without-x' instead of `./configure'. |
38 |
|
|
39 |
You can type `make bootstrap' instead of `make' to rebuild everything, |
You can type `make bootstrap' instead of `make' to rebuild everything, |
40 |
including byte-compiling the Lisp files. |
including byte-compiling the Lisp files. |
41 |
|
|
42 |
If you have not installed the GNU texinfo package on your system, the |
If you are compiling on Mac OS X versions before 10.2 and have not |
43 |
build will complain that makeinfo cannot be found. Instructions for |
installed the GNU texinfo package on your system, the build will |
44 |
installing the GNU texinfo package are given below. Alternatively, |
complain that makeinfo cannot be found. Instructions for installing the |
45 |
you can type `make -k' instead of `make' and safely ignore the error |
GNU texinfo package are given below. Alternatively, you can type `make |
46 |
messages and use the existing info files. |
-k' instead of `make' and safely ignore the error messages and use the |
47 |
|
existing info files. |
48 |
|
|
49 |
After Emacs is installed, you can run it by typing `emacs -nw' from a |
After Emacs is installed, you can run it by typing `emacs -nw' from a |
50 |
terminal (make sure your path contains /usr/local/bin) or by |
terminal (make sure your path contains /usr/local/bin) or by |
51 |
double-clicking on mac/Emacs.app in the Finder. At present, |
double-clicking on /Applications/Emacs.app in the Finder. To start |
52 |
command-line options cannot be passed to Emacs running under the Aqua |
Emacs as a GUI application from the terminal, the pathname to the |
53 |
GUI. This should soon be fixed. |
executable in the bundle, i.e., |
54 |
|
|
55 |
|
/Application/Emacs.app/Contents/MacOS/Emacs |
56 |
|
|
57 |
|
must be typed to the shell to enable Emacs to locate its resources |
58 |
|
correctly. You may want to create a symlink or alias to this path to |
59 |
|
quickly access both the terminal and GUI versions. |
60 |
|
|
61 |
|
If you are building Emacs to run on Mac OS X and X Window, you need to |
62 |
|
create a directory containing statically-linked X libraries. |
63 |
|
|
64 |
|
sudo mkdir /usr/X11R6/libstatic |
65 |
|
cd /usr/X11R6/libstatic |
66 |
|
sudo ln -s ../lib/lib*.a ../lib/X11 . |
67 |
|
|
68 |
|
Instead of typing `./configure' above, type |
69 |
|
|
70 |
|
./configure --without-carbon --with-x --x-libraries=/usr/X11R6/libstatic |
71 |
|
|
72 |
To use colors in a terminal, put the following lines in the file |
To use colors in a terminal, put the following lines in the file |
73 |
~/.termcap and log in again. |
~/.termcap and log in again. |
88 |
:sc=\E7:rc=\E8:cs=\E[%i%d;%dr: |
:sc=\E7:rc=\E8:cs=\E[%i%d;%dr: |
89 |
----- |
----- |
90 |
|
|
91 |
To build a binary distribution of Emacs for Mac OS X, run the shell |
To build the `info' files in versions prior to Mac OS X 10.2, you need |
92 |
script make-bin-dist in the `mac' directory. This will create a file |
to install the texinfo software. |
|
emacs-21.xx.yy-mac-bin.tar.gz. |
|
|
|
|
|
To install the binary distribution, untar the file and run the shell |
|
|
script osx-install in its top-level directory. |
|
|
|
|
|
To build the `info' files, you need to install the texinfo software. |
|
93 |
|
|
94 |
To install from source, obtain texinfo-4.2.tar.gz from ftp.gnu.org or |
To install from source, obtain texinfo-4.2.tar.gz from ftp.gnu.org or |
95 |
a mirror. Un-tar it, enter its directory and type |
a mirror. Un-tar it, enter its directory and type |
98 |
make |
make |
99 |
make install |
make install |
100 |
|
|
101 |
The last step needs to be performed as root. |
The last step may need to be performed as root (sudo make install). |
102 |
|
|
103 |
You may also like to install ispell, which will allow you to use |
You may also like to install ispell, which will allow you to use |
104 |
ispell and flyspell-mode. To install ispell from source, you first |
ispell and flyspell-mode. To install ispell from source, you first |
110 |
./configure --host=powerpc-apple-bsd |
./configure --host=powerpc-apple-bsd |
111 |
make |
make |
112 |
make install |
make install |
113 |
|
|
114 |
Again, the last step needs to be performed as root. Note that if you |
Again, the last step may need to be performed as root. Note that if you |
115 |
run `make check', the test for `pr' will fail. |
run `make check', the test for `pr' will fail. |
116 |
|
|
117 |
Get and un-tar ispell-3.2.06.tar.gz. Look for it here: |
Get and un-tar ispell-3.2.06.tar.gz. Look for it here: |
132 |
|
|
133 |
Run `make' and `make install', the latter as root. |
Run `make' and `make install', the latter as root. |
134 |
|
|
135 |
|
* BUILDING BINARY DISTRIBUTIONS FOR MAC OS X |
136 |
|
|
137 |
|
If you are intending to build a binary distribution of Emacs, there is |
138 |
|
a script that will greatly simplify the process. It is called |
139 |
|
make-package and it is contained in this directory. It will generate |
140 |
|
a disc image containing a installer bundle. By default the installer |
141 |
|
will place the emacs common files in /usr/local/* and the carbon |
142 |
|
application in /Applications. Typical usage would be |
143 |
|
|
144 |
|
./make-package |
145 |
|
|
146 |
|
After running, an compressed disk image of the installer will be placed |
147 |
|
in a file called EmacsInstaller.dmg. This file can be then distributed |
148 |
|
to whomever would like a binary distribution. Here are the common |
149 |
|
options to user |
150 |
|
|
151 |
|
--with-x - Use the X11 GUI instead of the Carbon GUI. |
152 |
|
--prefix=DIR - Place the common emacs files in the given DIR. The |
153 |
|
default is /usr/local. See note below if placing |
154 |
|
in /usr |
155 |
|
--self-contained - Place the common emacs files inside the Emacs.app |
156 |
|
itself. This makes the application trivial to |
157 |
|
uninstall and copy between computers. |
158 |
|
--app-symlink - Use a symlink inside the Application to the |
159 |
|
$prefix/bin/emacs to reduce disk space. Note, this |
160 |
|
option may removed in the future. |
161 |
|
|
162 |
|
If you are intending to build a binary distribution for X windows, you |
163 |
|
will probably want to follow the directions above to create static |
164 |
|
X11R6 libraries and run the make-package script like this |
165 |
|
|
166 |
|
./make-package --with-x -C,--x-libraries=/usr/X11R6/libstatic |
167 |
|
|
168 |
|
For usage of other options, use the --help option. |
169 |
|
|
170 |
* BUILDING EMACS ON MAC OS 8/9 |
* BUILDING EMACS ON MAC OS 8/9 |
171 |
|
|
210 |
|
|
211 |
* NOTES |
* NOTES |
212 |
|
|
213 |
Emacs should build and run on a PowerMac running Mac OS 8.6 - 10.1. |
Emacs should build and run on a PowerMac running Mac OS 8.6 - 10.2. |
214 |
|
|
215 |
You will need around 100 MB of disk space for the source files and |
You will need around 100 MB of disk space for the source files and |
216 |
intermediate files. |
intermediate files. |
229 |
generic application icon on the Mac OS X. A better looking one is |
generic application icon on the Mac OS X. A better looking one is |
230 |
coming soon. |
coming soon. |
231 |
|
|
232 |
|
On Mac OS X, installing the emacs files in /usr can cause issues with |
233 |
|
system sofware updates possibly overwriting the distribution. If this |
234 |
|
is a concern, as it should be in normal binary distributions, please |
235 |
|
use /usr/local as the prefix for installation. |
236 |
|
|
237 |
Enjoy! |
Enjoy! |
238 |
|
|