-
Notifications
You must be signed in to change notification settings - Fork 7
/
install.html
104 lines (98 loc) · 5.01 KB
/
install.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
<!DOCTYPE html>
<html lang='en'>
<head>
<meta charset='utf-8'>
<title>
How to learn Emacs :: Install the right Emacs
</title>
<link href='emacs.css' media='all' rel='stylesheet'>
</head>
<body>
<div id='sidebar'>
<div id='info'>
<h1>How to learn Emacs</h1>
<p>By <a href="http://david.rothlis.net">David Röthlisberger</a>.<br/>
Comments welcome at <a href="mailto:david@rothlis.net?subject=How%20to%20learn%20Emacs">david@rothlis.net</a>.<br/>
Last updated 24 Jun 2012.</p>
</div>
<div id='toc'>
<!-- Table of Contents -->
<ul>
<li><a href='howtolearn.html'>1. About this guide to Emacs</a></li>
<li><a href='why.html'>2. Why Emacs</a></li>
</ul>
<p>—Basic usage—</p>
<ul>
<li class='current'>3. Install the right Emacs</li>
<li><a href='tutorial.html'>4. The very basics</a></li>
<li><a href='basic_c.html'>5. Basic Unix/C workflow</a></li>
</ul>
<p>—Basic customisation—</p>
<ul>
<li><a href='customize_c.html'>6. cc-mode customization</a></li>
<li><a href='customize_colors.html'>7. Fix that awful color scheme</a></li>
<li><a href='customize_general.html'>8. General customization</a></li>
</ul>
<p>—Miscellaneous—</p>
<ul>
<li><a href='info.html'>9. Info documentation</a></li>
<li><a href='contribute_emacs.html'>10. Contributing to Emacs</a></li>
</ul>
<p>—Appendices—</p>
<ul>
<li><a href='ergonomics.html'>A. Ergonomics</a></li>
<li><a href='osx.html'>B. OS X</a></li>
<li><a href='contribute_guide.html'>C. Contributing to this guide</a></li>
<li><a href='glossary.html'>D. Glossary</a></li>
</ul>
</div>
<p>Copyright © 2012 <a href="http://david.rothlis.net">David Röthlisberger</a>.<br/>
This guide is released under the<br/>
<a rel="license" href="http://www.gnu.org/copyleft/fdl.html">GNU
Free Documentation License</a>.</p>
</div>
<div id='content2'>
<!-- Contents -->
<h1>Install the right Emacs</h1>
<p>Install the latest release of <a href="http://www.gnu.org/s/emacs/">GNU Emacs</a> (24.1
as of this writing). Not XEmacs, not EmacsW32, not AquaMacs, not Carbon Emacs.</p>
<h2>Linux</h2>
<p>Emacs is probably already installed; if not, use your distro’s package manager
(yum, apt-get, etc).</p>
<p>If your distro only has older Emacs packages, you could try finding a
third-party package repository, or <a href="http://www.gnu.org/software/emacs/emacs-faq.html#Compiling-and-installing-Emacs">building the latest version from source</a>
if you are comfortable doing so.</p>
<h2>OS X</h2>
<p>If you use <a href="http://www.macports.org/">macports</a>, install the <code>emacs-app</code> port,
which gives you a native OS X application. By default macports will install
Emacs.app into /Applications/MacPorts. If you use a laptop I recommend the
<code>fullscreen</code> variant (i.e. <code>port install emacs-app +fullscreen</code>) which adds the
command <code>ns-toggle-fullscreen</code> to Emacs.</p>
<p>If you use <a href="http://mxcl.github.com/homebrew/">homebrew</a>:
<code>brew install emacs --cocoa</code>.</p>
<p>Otherwise, you can use a <a href="http://emacsformacosx.com/">pre-built emacs</a>, but do
consider installing macports or homebrew so that you can easily install other
Unixy tools as you need them.</p>
<h2>Windows</h2>
<p>You are mostly on your own as I am not a Windows user; I apologize in advance
if some of the examples in this guide don’t work on your system, as I haven’t
tested on Windows.</p>
<p>You’ll want to download the latest <code>emacs-xx.x-bin-i386.zip</code> from
<a href="http://ftp.gnu.org/pub/gnu/emacs/windows/">http://ftp.gnu.org/pub/gnu/emacs/windows/</a> and unzip it into a directory of
your choice. Then run <code>addpm.exe</code> from the <code>bin</code> subdirectory, as an
administrator (this adds a start menu shortcut and various registry entries).</p>
<p>Some Emacs functionality requires Unixy tools like <code>find</code> and <code>grep</code>, which you
can get by installing a posix emulation environment such as <a href="http://www.gnu.org/software/emacs/windows/Other-useful-ports.html">Cygwin</a>. You will
have to ensure that the posix utilities are on the system PATH so that Emacs
can find them.</p>
<p>For further help refer to the <a href="http://www.gnu.org/software/emacs/windows/">GNU Emacs FAQ for MS Windows</a> and the (often outdated)
<a href="http://www.emacswiki.org/emacs/MsWindowsInstallation">EmacsWiki</a>.</p>
<h2>Remove any existing .emacs configuration</h2>
<p>If you have existing Emacs customizations in a <code>.emacs</code> file or <code>.emacs.d</code>
directory, you should move it out of the way if you want your Emacs behavior to
exactly mirror the examples in this guide.</p>
<!-- Contents -->
<p class='next'><a rel='next' href='tutorial.html'>Next: The very basics</a></p>
</div>
</body>
</html>