Skip to content

Commit

Permalink
Update recommended Emacs version to the newly-released 24.1.
Browse files Browse the repository at this point in the history
Note that I still need to update the "Color themes", "Installing third-
party elisp packages", and (maybe) "Installing packages from github"
sections in Chapter 7 to use an example other than the color-theme
package, which is now obsolete as Emacs 24 has color themes built in.
  • Loading branch information
drothlis committed Jun 24, 2012
1 parent 147cc8f commit 7dcba8a
Show file tree
Hide file tree
Showing 6 changed files with 26 additions and 37 deletions.
2 changes: 1 addition & 1 deletion contribute_emacs.haml
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ documentation string.
%h2 Making a patch in the 21st century[[2]]

Ideally you'd make the patch against the latest (unreleased) version of the
Emacs source code, instead of version 23.3. Someone else might even have fixed
Emacs source code, instead of version 24.1. Someone else might even have fixed
your problem already! The Emacs source code is hosted at [savannah.gnu.org](
http://savannah.gnu.org/projects/emacs) and you can grab the source code from
the official Bazaar repository:
Expand Down
4 changes: 2 additions & 2 deletions contribute_emacs.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
<h1>How to learn Emacs</h1>
<p>By <a href="http://david.rothlis.net">David Röthlisberger</a>.<br/>
Comments welcome at <a href="&#x6d;&#x61;&#x69;&#108;&#x74;&#x6f;&#x3a;&#100;&#97;&#118;&#105;&#x64;&#64;&#x72;&#x6f;&#116;&#x68;&#x6c;&#105;&#115;&#46;&#110;&#x65;&#x74;?subject=How%20to%20learn%20Emacs">&#100;&#97;&#x76;&#x69;&#x64;&#64;&#114;&#111;&#x74;&#x68;&#x6c;&#x69;&#x73;&#46;&#x6e;&#x65;&#x74;</a>.<br/>
Last updated 8 Apr 2012.</p>
Last updated 24 Jun 2012.</p>
</div>
<div id='toc'>
<!-- Table of Contents -->
Expand Down Expand Up @@ -99,7 +99,7 @@ <h2>Making a patch, the 1980s way</h2>
<div class='echoarea'><p>&nbsp;</p></div>
<h2>Making a patch in the 21st century<a id='fnref2' href='#fn2' class='footnote'>[2]</a></h2>
<p>Ideally you&rsquo;d make the patch against the latest (unreleased) version of the
Emacs source code, instead of version 23.3. Someone else might even have fixed
Emacs source code, instead of version 24.1. Someone else might even have fixed
your problem already! The Emacs source code is hosted at <a href="http://savannah.gnu.org/projects/emacs">savannah.gnu.org</a> and you can grab the source code from
the official Bazaar repository:</p>
<div class='do'>
Expand Down
15 changes: 8 additions & 7 deletions customize_colors.haml
Original file line number Diff line number Diff line change
Expand Up @@ -167,6 +167,10 @@ and find the `provide` form near the bottom).

%h2#themes Color themes

*Note: This section and the next, which deal with the `color-theme` package,
were written for Emacs 23. `color-theme` is obsolete in Emacs 24, so I need
to find a better example for installing third-party packages.*

Maybe you already have a favourite color theme, like [Zenburn](
http://slinky.imukuppi.org/zenburnpage/) or [Solarized](
http://ethanschoonover.com/solarized). There are Emacs implementations
Expand All @@ -175,14 +179,11 @@ https://github.com/sellout/emacs-color-theme-solarized)) built on top of the
[`color-theme`]( http://www.nongnu.org/color-theme/) minor mode. `color-theme`
is a third-party package; it doesn't come with Emacs.

Note that Emacs 24, which hasn't been officially released yet, provides a
built-in mechanism for defining multiple color themes. Nevertheless, I'll walk
you through the process of installing third-party packages using `color-theme`
and the Solarized theme as examples.

/ TODO: Find a better example once Emacs 24 is released.
Note that Emacs 24 provides a built-in mechanism for defining multiple color
themes. Nevertheless, I'll walk you through the process of installing
third-party packages using `color-theme` and the Solarized theme as examples.

Emacs 24 will also come with a package management system, so--as long as the
Emacs 24 also comes with a package management system, so--as long as the
package's author has taken advantage of the new mechanism--the manual
installation procedure described below will not be necessary either.

Expand Down
17 changes: 10 additions & 7 deletions customize_colors.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
<h1>How to learn Emacs</h1>
<p>By <a href="http://david.rothlis.net">David Röthlisberger</a>.<br/>
Comments welcome at <a href="&#x6d;&#x61;&#x69;&#108;&#x74;&#x6f;&#x3a;&#100;&#97;&#118;&#105;&#x64;&#64;&#x72;&#x6f;&#116;&#x68;&#x6c;&#105;&#115;&#46;&#110;&#x65;&#x74;?subject=How%20to%20learn%20Emacs">&#100;&#97;&#x76;&#x69;&#x64;&#64;&#114;&#111;&#x74;&#x68;&#x6c;&#x69;&#x73;&#46;&#x6e;&#x65;&#x74;</a>.<br/>
Last updated 8 Apr 2012.</p>
Last updated 24 Jun 2012.</p>
</div>
<div id='toc'>
<!-- Table of Contents -->
Expand Down Expand Up @@ -166,17 +166,20 @@ <h2 id='diff'>diff-mode</h2>
but to double-check: <code><a class='glossary' href='glossary.html#keys'>C-h f diff-mode</a></code>, follow the link to <code>diff-mode.el.gz</code>,
and find the <code>provide</code> form near the bottom).</p>
<h2 id='themes'>Color themes</h2>
<p><em>Note: This section and the next, which deal with the <code>color-theme</code> package,
were written for Emacs 23. <code>color-theme</code> is obsolete in Emacs 24, so I need
to find a better example for installing third-party packages.</em></p>

<p>Maybe you already have a favourite color theme, like <a href="http://slinky.imukuppi.org/zenburnpage/">Zenburn</a> or <a href="http://ethanschoonover.com/solarized">Solarized</a>. There are Emacs implementations
(<a href="https://github.com/bbatsov/zenburn-emacs">Zenburn</a>, <a href="https://github.com/sellout/emacs-color-theme-solarized">Solarized</a>) built on top of the
<a href="http://www.nongnu.org/color-theme/"><code>color-theme</code></a> <a class='glossary' href='glossary.html#minormode'>minor mode</a>. <code>color-theme</code>
is a third-party package; it doesn&rsquo;t come with Emacs.</p>

<p>Note that Emacs 24, which hasn&rsquo;t been officially released yet, provides a
built-in mechanism for defining multiple color themes. Nevertheless, I&rsquo;ll walk
you through the process of installing third-party packages using <code>color-theme</code>
and the Solarized theme as examples.</p>
<!-- TODO: Find a better example once Emacs 24 is released. -->
<p>Emacs 24 will also come with a package management system, so&mdash;as long as the
<p>Note that Emacs 24 provides a built-in mechanism for defining multiple color
themes. Nevertheless, I&rsquo;ll walk you through the process of installing
third-party packages using <code>color-theme</code> and the Solarized theme as examples.</p>

<p>Emacs 24 also comes with a package management system, so&mdash;as long as the
package&rsquo;s author has taken advantage of the new mechanism&mdash;the manual
installation procedure described below will not be necessary either.</p>
<h2 id='packages'>Installing third-party elisp packages</h2>
Expand Down
14 changes: 2 additions & 12 deletions install.haml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
%h1 Install the right Emacs

Install the latest release of [GNU Emacs]( http://www.gnu.org/s/emacs/) (23.4
Install the latest release of [GNU Emacs]( http://www.gnu.org/s/emacs/) (24.1
as of this writing). Not XEmacs, not EmacsW32, not AquaMacs, not Carbon Emacs.

%h2 Linux
Expand All @@ -9,8 +9,7 @@ Emacs is probably already installed; if not, use your distro's package manager
(yum, apt-get, etc).

If your distro only has older Emacs packages, you could try finding a
third-party package repository (such as those listed in the ["Emacs
24"](#emacs24) section below), or [building the latest version from source](
third-party package repository, or [building the latest version from source](
http://www.gnu.org/software/emacs/emacs-faq.html#Compiling-and-installing-Emacs)
if you are comfortable doing so.

Expand Down Expand Up @@ -55,12 +54,3 @@ http://www.gnu.org/software/emacs/windows/) and the (often outdated)
If you have existing Emacs customizations in a `.emacs` file or `.emacs.d`
directory, you should move it out of the way if you want your Emacs behavior to
exactly mirror the examples in this guide.

%h2#emacs24 Emacs 24

Version 24 has not been officially released but is reportedly very stable. Use
at your own risk. Pre-built packages from the latest source are available for
[Debian]( http://emacs.naquadah.org/), [Ubuntu](
https://launchpad.net/~cassou/+archive/emacs), [OS X](
http://emacsformacosx.com/builds#Pretests), and [Windows](
http://code.google.com/p/emacs-for-windows/).
11 changes: 3 additions & 8 deletions install.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
<h1>How to learn Emacs</h1>
<p>By <a href="http://david.rothlis.net">David Röthlisberger</a>.<br/>
Comments welcome at <a href="&#x6d;&#x61;&#x69;&#108;&#x74;&#x6f;&#x3a;&#100;&#97;&#118;&#105;&#x64;&#64;&#x72;&#x6f;&#116;&#x68;&#x6c;&#105;&#115;&#46;&#110;&#x65;&#x74;?subject=How%20to%20learn%20Emacs">&#100;&#97;&#x76;&#x69;&#x64;&#64;&#114;&#111;&#x74;&#x68;&#x6c;&#x69;&#x73;&#46;&#x6e;&#x65;&#x74;</a>.<br/>
Last updated 14 Apr 2012.</p>
Last updated 24 Jun 2012.</p>
</div>
<div id='toc'>
<!-- Table of Contents -->
Expand Down Expand Up @@ -54,15 +54,14 @@ <h1>How to learn Emacs</h1>
<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> (23.4
<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&rsquo;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 (such as those listed in the <a href="#emacs24">&ldquo;Emacs
24&rdquo;</a> section below), or <a href="http://www.gnu.org/software/emacs/emacs-faq.html#Compiling-and-installing-Emacs">building the latest version from source</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,
Expand Down Expand Up @@ -98,10 +97,6 @@ <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>
<h2 id='emacs24'>Emacs 24</h2>
<p>Version 24 has not been officially released but is reportedly very stable. Use
at your own risk. Pre-built packages from the latest source are available for
<a href="http://emacs.naquadah.org/">Debian</a>, <a href="https://launchpad.net/~cassou/+archive/emacs">Ubuntu</a>, <a href="http://emacsformacosx.com/builds#Pretests">OS X</a>, and <a href="http://code.google.com/p/emacs-for-windows/">Windows</a>.</p>
<!-- Contents -->
<p class='next'><a rel='next' href='tutorial.html'>Next: The very basics</a></p>
</div>
Expand Down

0 comments on commit 7dcba8a

Please sign in to comment.