Emacs Lisp Makefile
Pull request Compare This branch is 10 commits behind haskell:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
doc
images
tests
.gitignore
.travis.yml
CONTRIBUTING.md
COPYING
Makefile
NEWS
README.md
appveyor.yml
ghc-core.el
ghci-script-mode.el
haskell-align-imports.el
haskell-c2hs.el
haskell-cabal.el
haskell-collapse.el
haskell-commands.el
haskell-compat.el
haskell-compile.el
haskell-complete-module.el
haskell-completions.el
haskell-customize.el
haskell-debug.el
haskell-decl-scan.el
haskell-doc.el
haskell-font-lock.el
haskell-ghc-support.el
haskell-hoogle.el
haskell-indent.el
haskell-indentation.el
haskell-interactive-mode.el
haskell-lexeme.el
haskell-load.el
haskell-menu.el
haskell-mode-pkg.el
haskell-mode.el
haskell-modules.el
haskell-move-nested.el
haskell-navigate-imports.el
haskell-presentation-mode.el
haskell-process.el
haskell-repl.el
haskell-sandbox.el
haskell-session.el
haskell-sort-imports.el
haskell-string.el
haskell-unicode-input-method.el
haskell-utils.el
haskell.el
highlight-uses-mode.el
inf-haskell.el
logo.svg
w3m-haddock.el

README.md

Haskell Mode for Emacs

This is an Emacs mode for editing, debugging and developing Haskell programs. Home page.

Coverage Status Build Status Build status Melpa Status Melpa Stable Status License GPL3 Twitter Follow

I just want to thank everybody involved in one way or another with the Haskell Emacs tooling. It is one of the best language experiences I had in Emacs. -- cocreature, 2015-03-01

I've been using it for a long time and love it. Great work on haskell-mode! Keep up the good work! -- LukeHoersten, 2015-04-02

This sounds wonderful. Does anything similar exist for Vim? -- earldouglas, 2015-07-02

Users manual: latest version, older versions: 13.12, 13.14, 13.16, 13.18, 13.20.

Quick Installation

Make sure you have this in your init file (usually ~/.emacs). If you already have custom-set-variables, merge its contents:

(require 'package)
(custom-set-variables
 ;; custom-set-variables was added by Custom.
 ;; If you edit it by hand, you could mess it up, so be careful.
 ;; Your init file should contain only one such instance.
 ;; If there is more than one, they won't work right.
 '(package-archives
   (quote
    (("gnu" . "http://elpa.gnu.org/packages/")
     ("melpa-stable" . "http://stable.melpa.org/packages/")))))

Then run emacs, and evaluate:

M-x package-refresh-contents

and then follow by

M-x package-install RET haskell-mode

Voila! haskell-mode is installed! You should be able to edit Haskell source code in color now.

Haskell-mode has much much much more to offer but the above should get you going!

Advanced configuration

For setup instructions, please consult the integrated haskell-mode Info manual which can be accessed after installation via M-x info-display-manual [RET] haskell-mode. Alternatively, you can also direct your browser to the the online haskell-mode manual for setup and user guide.

Installation - more information

haskell-mode supports GNU Emacs version 24.3 or later.

haskell-mode is available from melpa-stable (releases) and melpa (git snapshots).

Other means of obtaining haskell-mode include el-get, Emacs Prelude and Debian package.

Installation from git repository

Running haskell-mode directly from sources is easy but requires a little preparation:

  • git clone https://github.com/haskell/haskell-mode.git into a suitable directory, e.g. ~/lib/emacs/haskell-mode/ where ~ stands for your home directory.

  • Assuming you have unpacked the various haskell-mode modules (haskell-mode.el and the rest) in the directory ~/lib/emacs/haskell-mode/, you need to generate various files, the autoloads file (haskell-mode-autoloads.el) is one among them. Invoke:

make EMACS=/path/to/your/emacs

and then adding the following command to your .emacs:

(add-to-list 'load-path "~/lib/emacs/haskell-mode/")
(require 'haskell-mode-autoloads)
(add-to-list 'Info-default-directory-list "~/lib/emacs/haskell-mode/")

Contributing

If you followed the above you are just a couple of steps away from contributing to haskell-mode.

haskell-mode is actively seeking contributions from users of haskell-mode. For more information have a look at the wiki page on contributing.

Getting in contact

Have fun!