Re: misleading install instruction in emacs/mac/INSTALL

[YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>]

>>>>> On Tue, 21 Nov 2006 02:47:56 -0500, Richard Stallman <rms@gnu.org> said:

>     This produced a version that appears to run OK in the Mac window
> system but /usr/local/bin/emacs did not run in X windows.
> Apparently it is necessary to do two installations, one using

> Would someone please clarify the instructions?

Does the following change make things clear?

				     YAMAMOTO Mitsuharu
				mituharu@math.s.chiba-u.ac.jp

Index: mac/INSTALL
===================================================================
RCS file: /cvsroot/emacs/emacs/mac/INSTALL,v
retrieving revision 1.27
diff -c -r1.27 INSTALL
*** mac/INSTALL	8 Nov 2006 08:03:21 -0000	1.27
--- mac/INSTALL	22 Nov 2006 08:19:14 -0000
***************
*** 43,65 ****
  -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.,
  
    /Application/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.
! 
! If you are building Emacs to run on Mac OS X and X Window System,
! instead of typing `./configure' above, type
  
    ./configure --with-x
  
  
  To use colors in a terminal, put the following lines in the file
  ~/.termcap and log in again.
--- 43,73 ----
  -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 text-only terminal
! version, some Carbon-specific functions such as `mac-set-file-creator'
! are 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
  
  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 optionally 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 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.