Mercurial > emacs

comparison mac/INSTALL @ 49091:4d9ad5d4f2d4

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
* INSTALL: Added documentation about --enable-carbon-app and changed documentation concerning Emacs.app location Removed some of the documentation about make-package that isn't needed Changed comment about requiring root permission to install to saying that it might be necessary depending on where you install Refered to /usr caveat in more places * make-package (make_options): Use new carbon_appdir option to specify directory to install Application and lets the makefile install
author Steven Tamm <steventamm@mac.com>
date Tue, 07 Jan 2003 05:50:36 +0000
parents 0f5f21cee53f
children 23a1cea22d13
comparison
equal deleted inserted replaced
49090:fc1853b3e3dd 49091:4d9ad5d4f2d4
17 17
18 You should be able to build Emacs on Mac OS X by typing the following 18 You should be able to build Emacs on Mac OS X by typing the following
19 commands at the top-level directory after the source distribution is 19 commands at the top-level directory after the source distribution is
20 un-tarred. 20 un-tarred.
21 21
22 ./configure 22 ./configure --enable-carbon-app
23 make 23 make
24 make install 24 make install
25 25
26 The last step must be performed as root. 26 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>
27 34
28 If you have X Window installed on your Mac and you are building Emacs 35 If you have X Window installed on your Mac and you are building Emacs
29 to run under Carbon and not X Window, you need to type `./configure 36 to run under Carbon and not X Window, you need to type `./configure
30 --without-x' instead of `./configure'. 37 --without-x' instead of `./configure'.
31 38
32 You can type `make bootstrap' instead of `make' to rebuild everything, 39 You can type `make bootstrap' instead of `make' to rebuild everything,
33 including byte-compiling the Lisp files. 40 including byte-compiling the Lisp files.
34 41
35 If you have not installed the GNU texinfo package on your system, the 42 If you are compiling on Mac OS X versions before 10.2 and have not
36 build will complain that makeinfo cannot be found. Instructions for 43 installed the GNU texinfo package on your system, the build will
37 installing the GNU texinfo package are given below. Alternatively, 44 complain that makeinfo cannot be found. Instructions for installing the
38 you can type `make -k' instead of `make' and safely ignore the error 45 GNU texinfo package are given below. Alternatively, you can type `make
39 messages and use the existing info files. 46 -k' instead of `make' and safely ignore the error messages and use the
47 existing info files.
40 48
41 After Emacs is installed, you can run it by typing `emacs -nw' from a 49 After Emacs is installed, you can run it by typing `emacs -nw' from a
42 terminal (make sure your path contains /usr/local/bin) or by 50 terminal (make sure your path contains /usr/local/bin) or by
43 double-clicking on mac/Emacs.app in the Finder. To start Emacs as a 51 double-clicking on /Applications/Emacs.app in the Finder. To start
44 GUI application from the terminal, the pathname to the executable in 52 Emacs as a GUI application from the terminal, the pathname to the
45 the bundle, i.e., 53 executable in the bundle, i.e.,
46 54
47 .../emacs/mac/Emacs.app/Contents/MacOS/Emacs 55 /Application/Emacs.app/Contents/MacOS/Emacs
48 56
49 must be typed to the shell to enable Emacs to locate its resources 57 must be typed to the shell to enable Emacs to locate its resources
50 correctly. 58 correctly. You may want to create a symlink or alias to this path to
59 quickly access both the terminal and GUI versions.
51 60
52 If you are building Emacs to run on Mac OS X and X Window, you need to 61 If you are building Emacs to run on Mac OS X and X Window, you need to
53 create a directory containing statically-linked X libraries. 62 create a directory containing statically-linked X libraries.
54 63
55 sudo mkdir /usr/X11R6/libstatic 64 sudo mkdir /usr/X11R6/libstatic
77 :ku=\EOA:kd=\EOB:kr=\EOC:kl=\EOD:kb=^H:\ 86 :ku=\EOA:kd=\EOB:kr=\EOC:kl=\EOD:kb=^H:\
78 :ho=\E[H:k1=\EOP:k2=\EOQ:k3=\EOR:k4=\EOS:pt:sr=2*\EM:vt#3:xn:\ 87 :ho=\E[H:k1=\EOP:k2=\EOQ:k3=\EOR:k4=\EOS:pt:sr=2*\EM:vt#3:xn:\
79 :sc=\E7:rc=\E8:cs=\E[%i%d;%dr: 88 :sc=\E7:rc=\E8:cs=\E[%i%d;%dr:
80 ----- 89 -----
81 90
82 To build the `info' files, you need to install the texinfo software. 91 To build the `info' files in versions prior to Mac OS X 10.2, you need
92 to install the texinfo software.
83 93
84 To install from source, obtain texinfo-4.2.tar.gz from ftp.gnu.org or 94 To install from source, obtain texinfo-4.2.tar.gz from ftp.gnu.org or
85 a mirror. Un-tar it, enter its directory and type 95 a mirror. Un-tar it, enter its directory and type
86 96
87 ./configure 97 ./configure
88 make 98 make
89 make install 99 make install
90 100
91 The last step needs to be performed as root. 101 The last step may need to be performed as root (sudo make install).
92 102
93 You may also like to install ispell, which will allow you to use 103 You may also like to install ispell, which will allow you to use
94 ispell and flyspell-mode. To install ispell from source, you first 104 ispell and flyspell-mode. To install ispell from source, you first
95 need to install GNU textutils. 105 need to install GNU textutils.
96 106
99 109
100 ./configure --host=powerpc-apple-bsd 110 ./configure --host=powerpc-apple-bsd
101 make 111 make
102 make install 112 make install
103 113
104 Again, the last step needs to be performed as root. Note that if you 114 Again, the last step may need to be performed as root. Note that if you
105 run `make check', the test for `pr' will fail. 115 run `make check', the test for `pr' will fail.
106 116
107 Get and un-tar ispell-3.2.06.tar.gz. Look for it here: 117 Get and un-tar ispell-3.2.06.tar.gz. Look for it here:
108 118
109 http://fmg-www.cs.ucla.edu/geoff/ispell.html 119 http://fmg-www.cs.ucla.edu/geoff/ispell.html
140 150
141 --with-x - Use the X11 GUI instead of the Carbon GUI. 151 --with-x - Use the X11 GUI instead of the Carbon GUI.
142 --prefix=DIR - Place the common emacs files in the given DIR. The 152 --prefix=DIR - Place the common emacs files in the given DIR. The
143 default is /usr/local. See note below if placing 153 default is /usr/local. See note below if placing
144 in /usr 154 in /usr
145 --without-app - Do not install the carbon gui in /Applications
146 This will be commonly used for terminal-only or X
147 windows installs.
148 --self-contained - Place the common emacs files inside the Emacs.app 155 --self-contained - Place the common emacs files inside the Emacs.app
149 itself. This makes the application trivial to 156 itself. This makes the application trivial to
150 uninstall and copy between computers. 157 uninstall and copy between computers.
151 --app-symlink - Use a symlink inside the Application to the 158 --app-symlink - Use a symlink inside the Application to the
152 $prefix/bin/emacs to reduce disk space. Note, this 159 $prefix/bin/emacs to reduce disk space. Note, this