Point people to clojure-doc.org instead.

Author: technomancy

README.md

@@ -3,6 +3,8 @@
 Provides Emacs font-lock, indentation, and navigation for the
 [Clojure programming language](http://clojure.org).
 
+A more thorough walkthrough is available at [clojure-doc.org](http://clojure-doc.org/articles/tutorials/emacs.html)
+
 ## Installation
 
 Available on both [Marmalade](http://marmalade-repo.org/packages/clojure-mode) and
@@ -35,6 +37,7 @@ of code instead:
 And then you can install:
 
 <kbd>M-x package-refresh-contents</kbd>
+
 <kbd>M-x package-install [RET] clojure-mode [RET]</kbd>
 
 or if you'd rather keep it in your dotfiles:
@@ -53,10 +56,9 @@ and `require`ing it.
 
 This source repository also includes `clojure-test-mode.el`, which
 provides support for running Clojure tests (using the `clojure.test`
-framework) via nrepl.el or SLIME and seeing feedback in the test
-buffer about which tests failed or errored. The installation
-instructions above should work for clojure-test-mode as well.
-(nrepl.el support is still in progress.)
+framework) via nrepl.el and seeing feedback in the test buffer about
+which tests failed or errored. The installation instructions above
+should work for clojure-test-mode as well.
 
 Once you have a repl session active, you can run the tests in the
 current buffer with <kbd>C-c C-,</kbd>. Failing tests and errors will be
@@ -77,26 +79,29 @@ its tests would be in `test/my/project/frob_test.clj` in the
 ## Paredit
 
 Using clojure-mode with
-[paredit](http://mumble.net/~campbell/emacs/paredit.el) is highly
-recommended. It is also available using package.el from the above
-archives.
+[Paredit](http://mumble.net/~campbell/emacs/paredit.el) is highly
+recommended. It helps ensure the structure of your forms is not
+compromised and offers a number of operations that work on code
+structure at a higher level than just characters and words.
+
+It is also available using package.el from the above archives.
 
-Use paredit as you normally would any other minor mode; for instance:
+Use Paredit as you normally would any other minor mode; for instance:
 
 ```lisp
 ;; (require 'paredit) if you didn't install it via package.el
 (add-hook 'clojure-mode-hook 'paredit-mode)
 ```
 
 See [the cheat sheet](http://www.emacswiki.org/emacs/PareditCheatsheet)
-for paredit usage hints.
+for Paredit usage hints.
 
 ## REPL Interaction
 
 A number of options exist for connecting to a running Clojure process
 and evaluating code interactively.
 
-## Basic REPL
+### Basic REPL
 
 Use <kbd>M-x run-lisp</kbd> to open a simple REPL subprocess using
 [Leiningen](http://github.com/technomancy/leiningen). Once that has
@@ -106,18 +111,18 @@ opened, you can use <kbd>C-c C-r</kbd> to evaluate the region or
 If you don't use Leiningen, you can set `inferior-lisp-program` to
 a different REPL command.
 
-## nrepl.el
+### nrepl.el
 
 You can also use [Leiningen](http://leiningen.org) to start an
 enhanced REPL via [nrepl.el](https://github.com/kingtim/nrepl.el).
 
-## Ritz
+### Ritz
 
 Another option is [Ritz](https://github.com/pallet/ritz), which is a
 bit more complicated but offers advanced debugging functionality using
 SLIME.
 
-## Swank Clojure
+### Swank Clojure
 
 SLIME is available via
 [swank-clojure](http://github.com/technomancy/swank-clojure) in `clojure-mode` 1.x.

doc/gnu-linux-setup.md

@@ -4,100 +4,5 @@
 excellent support for Clojure programming and is widely used within
 the Clojure community.
 
-
-## Installation
-
-For installing Emacs and generally finding your way around Emacs on
-your platform, proceed now to one of the platform-specific docs:
-
- * [GNU/Linux setup](gnu-linux-setup.md)
- * [Mac OS X setup](os-x-setup.md)
- * [MS Windows setup](ms-windows-setup.md)
-
-
-## Configuration Overview
-
-Your main Emacs config and package directory is `~/.emacs.d`.
-Create this directory if it does not already exist.
-
-Your main Emacs config file is `~/.emacs.d/init.el`. You may create
-this file if it does not already exist.
-
-Once you've got Emacs installed, typical configuration for use
-with Clojure includes:
-
- * enabling the use of a remote Emacs package repository
- * installing clojure-mode (provides support for syntax highlighting
- and proper indentation for Clojure files (.clj files))
- * optionally enabling paredit mode (advanced support for working with
- expressions in parentheses/brackets)
-
-and then deciding if you want to use an interactive interface to the
-Clojure repl from inside of Emacs. If you want this, the two routes to
-choose from are:
-
- * use the "inferior-lisp" mode, or
- * use SLIME and Swank
-
-See below for discussion on each of these options.
-
-
-## Package Repository
-
-Emacs packages extend the editor in various ways, and (as of version
-24) Emacs can install them from a remote repository. All the packages
-we'll need here can be found in the [Melpa](http://melpa.milkbox.net/)
-repository. Tell Emacs about melpa by adding the following to your
-`~/.emacs.d/init.el` file:
-
-```lisp
-(require 'package)
-(add-to-list 'package-archives
- '("melpa" . "http://melpa.milkbox.net/packages/") t)
-(package-initialize)
-```
-
-
-## Clojure Mode
-
-Emacs uses so-called "major modes" (as in, "mode of operation") to
-provide filetype-specific editor support. For example, you edit a Java
-file using the Emacs java mode, and Clojure using a clojure mode.
-Emacs doesn't come with a Clojure mode by default, so we must install it.
-
-Install clojure-mode while running Emacs. Hit <kbd>M-x package-install
-RET clojure-mode</kbd>. After doing this, Emacs should automatically
-recognize .clj files as Clojure files when you open them.
-
-See [Clojure Mode's readme](https://github.com/technomancy/clojure-mode/blob/master/README.md) for more info on using it.
-
-
-## Paredit Mode
-
-todo
-
-
-## Clojure Test Mode
-
-todo
-
-
-# REPL Interaction
-
-If you like, you can simply interact with the Clojure repl that
-[Leiningen](http://leiningen.org/index.html) provides for you (via
-`lein repl`) --- totally separate from Emacs or in a shell buffer.
-However, Emacs can provide access to the repl from within a
-clojure-mode buffer if you prefer:
-
- * The simplest way to interact with the repl from within Emacs is to
- [use inferior-lisp](inferior-lisp.md).
-
- * For more functionality, [use slime & swank](https://github.com/technomancy/swank-clojure/blob/master/README.md).
-
-
-# Detailed Emacs Documentation
-
-GNU Emacs provides excellent built-in documention which is available
-within the editor (see "C-h") and also
-[online](http://www.gnu.org/software/emacs/manual/html_node/emacs/index.html).
+The documentation here has been replaced by
+[the Emacs tutorial at clojure-doc.org](http://clojure-doc.org/articles/tutorials/emacs.html)