<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">\documentclass[onecolumn,letterpaper,11pt]{article}

%===================================================================
\input{../common_latex_packages}
\input{../common_latex_definitions}
\input{../common_latex_help_format}
%===================================================================

\begin{document}

\begin{labcover}
\labtitle{Help Topic: Getting a more Graphical Emacs for MacOS}
\vspace{0.1in}
\labdate{Spring 2015}
\vspace{0.1in}
\labauth{Michael Benjamin, mikerb@mit.edu}
\labauth{Department of Mechanical Engineering, CSAIL}
\labauth{MIT, Cambridge MA 02139}
\labline
\end{labcover}

\wikidoc{file=Help.EMCGetOSXG}
\wikidoc{auth=mikerb@mit.edu}

%====================================================================
\section*{Getting a more Graphical Emacs for Mac OS X}
%====================================================================

A version of emacs with a more graphical front end is also available
in OSX.  This help topic describes how to install this version. Even
if you have a version of emacs in \var{/usr/bin/}, I still recommend
getting the version with a the graphical front end for heavy use
editing like writing source code.  Both versions will co-exist just
fine.

%====================================================================
\subsection*{How to tell if the graphical Emacs is already installed}

Your machine may already have this version of emacs installed. Note the 
executable of this version typically installs as Emacs with a capital E.
To check:

\vspace{0.15in}
\begin{consoleverb}
 $ which Emacs
 /Applications/Emacs.app/Contents/MacOS/Emacs
\end{consoleverb}
\vspace{0.15in}

\noindent
If you get a response like the one above, you're all set. If Emacs is
not installed you will get a response like the one below:

\vspace{0.15in}
\begin{consoleverb}
 $ which Emacs
 Emacs: Command not found
\end{consoleverb}
\vspace{0.15in}

\noindent
In this case you likely just do not have Emacs installed.  However it
is also possible that you just don't have the above directory in your
shell path. To rule this out, try the following:

\vspace{0.15in}
\begin{consoleverb}
 $ cd  /Applications/Emacs.app/Contents/MacOS
 $ which ./Emacs
 ./Emacs
\end{consoleverb}
\vspace{0.15in}

\noindent 
If you see the above, it's just a matter of adding the above directory to 
your shell path. Do this now, or see the help topic on augmenting your shell path:

\urlxx{http://oceanai.mit.edu/ivpman/help/help-augmenting-the-shell-path}

%====================================================================
\subsection*{Getting the graphical version of Emacs}

The GUI version of emacs may be obtained by going to
\urlx{http://emacsformacosx.com} and following the instructions for installing. 
You will need admin/root privileges for this. This will install the
emacs binary in:

\vspace{0.15in}
\begin{consoleverb}
  /Applications/Emacs.app/Contents/MacOS/
\end{consoleverb}
\vspace{0.15in}

\noindent 
You will need to add this directory to your shell path. If you don't know
how to do this, see the help topic on augmenting your shell path:

\urlxx{http://oceanai.mit.edu/ivpman/help/help-augmenting-the-shell-path}

\noindent
Once this is done you can begin using emacs to create or edit a file by
typing the following on the command line:

\vspace{0.15in}
\begin{consoleverb}
 $ Emacs newfile
\end{consoleverb}
\vspace{0.15in}

\noindent
This will open a new window. You can quit by typing \var{control-x}
followed by \var{control-q}. Or if you want to save your edits,
type \var{control-x}, \var{control-s} before quitting.

\pskip

You may notice that, for saving and quitting, there are nice little
icons on the top of the window for saving a file, and you can
select \var{Quit Emacs} from the Emacs Apple pull-down menu.  {\em
Resist the temptation to use these!!!!} One of the goals in
introducing you to emacs is to help you become efficient. Use the
keyboard method for doing your business in emacs. If you have to touch
your mouse, you're probably doing things wrong/inefficiently. These
inefficiencies really add up over time. Furthermore, when you inevitably 
need to remotely log into a robot and use emacs to edit a remote file, 
you won't be able to use the GUI ways of navigating emacs. The keyboard
will be all you have. 

\end{document}
</pre></body></html>