/[emacs]/emacs/mac/INSTALL
ViewVC logotype

Diff of /emacs/mac/INSTALL

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.7 by akochoi, Fri Apr 26 23:39:04 2002 UTC revision 1.7.2.1 by miles, Fri Apr 4 06:20:42 2003 UTC
# Line 19  You should be able to build Emacs on Mac Line 19  You should be able to build Emacs on Mac
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.
# Line 62  vt100|vt100-am|vt100am|dec vt100:\ Line 88  vt100|vt100-am|vt100am|dec vt100:\
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
# Line 78  a mirror.  Un-tar it, enter its director Line 98  a mirror.  Un-tar it, enter its director
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
# Line 90  Un-tar it, enter its directory, type Line 110  Un-tar it, enter its directory, type
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:
# Line 112  typed Line 132  typed
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    
# Line 156  dialog and include the Profiler PPC.Lib Line 210  dialog and include the Profiler PPC.Lib
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.
# Line 175  NT, define GNU_ICON in mac/src/Emacs.r. Line 229  NT, define GNU_ICON in mac/src/Emacs.r.
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    

Legend:
Removed from v.1.7  
changed lines
  Added in v.1.7.2.1

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26