Skip to content
Emacs mode for Haskell
Emacs Lisp Makefile
Latest commit 5d58314 May 3, 2016 @gracjan gracjan Merge pull request #1306 from mdorman/cabal-direct
Fix logic for running cabal directly.
Failed to load latest commit information.
doc Improve Getting Help section Apr 21, 2016
images Add star history 700 stars Apr 1, 2016
tests Demonstrate the problem with haskell-process-do-cabal. May 3, 2016
.gitignore Add support for embedding git version in texinfo manual Jul 4, 2013
.travis.yml Set EMACS env var even in documentation build mode Mar 6, 2016
CONTRIBUTING.md Update CONTRIBUTING.md Jan 16, 2016
COPYING Add GNU GPL text file Jun 10, 2015
Makefile Don't message when EMACS shell variable is void May 1, 2016
NEWS Write NEWS for 13.12 release. Mar 11, 2015
README.md Officially support only Emacs 24.3 and later Apr 9, 2016
ghc-core.el Defcustoms should not be autoloaded Jan 3, 2016
ghci-script-mode.el Use setq-local and defvar-local Apr 9, 2016
haskell-align-imports.el Defcustoms should not be autoloaded Jan 3, 2016
haskell-c2hs.el get rid of haskell--rx-let macro Mar 15, 2016
haskell-cabal.el Use setq-local and defvar-local Apr 9, 2016
haskell-checkers.el Use setq-local and defvar-local Apr 9, 2016
haskell-collapse.el globally: turn on lexical bindings Aug 23, 2015
haskell-commands.el Remove unnecessary hashes Mar 21, 2016
haskell-compat.el Cleanup haskell-compat.el Feb 8, 2016
haskell-compile.el Use setq-local and defvar-local Apr 9, 2016
haskell-complete-module.el Defcustoms should not be autoloaded Jan 3, 2016
haskell-completions.el Autoload haskell-completions-completion-at-point May 1, 2016
haskell-customize.el Change a couple hook properties Mar 10, 2016
haskell-debug.el Move haskell-interactive-prompt-state stuff to utils package Mar 21, 2016
haskell-decl-scan.el Use setq-local and defvar-local Apr 9, 2016
haskell-doc.el Use setq-local and defvar-local Apr 9, 2016
haskell-font-lock.el Sience possible messages from modes May 1, 2016
haskell-hoogle.el Move haskell-interactive-prompt-state stuff to utils package Mar 21, 2016
haskell-indent.el Use setq-local and defvar-local Apr 9, 2016
haskell-indentation.el Add multiple expression continuation possibilities Apr 21, 2016
haskell-interactive-mode.el Use setq-local and defvar-local Apr 9, 2016
haskell-lexeme.el Add escape sequences to char literals Apr 10, 2016
haskell-load.el Fix logic for running cabal directly. May 3, 2016
haskell-menu.el Use setq-local and defvar-local Apr 9, 2016
haskell-mode-pkg.el Officially support only Emacs 24.3 and later Apr 9, 2016
haskell-mode.el Autoload haskell-completions-completion-at-point May 1, 2016
haskell-modules.el move `haskell-stylish-save` to haskell-customize Nov 26, 2015
haskell-move-nested.el globally: turn on lexical bindings Aug 23, 2015
haskell-navigate-imports.el Convert all tabs to spaces Mar 15, 2016
haskell-presentation-mode.el Use setq-local and defvar-local Apr 9, 2016
haskell-process.el Convert all tabs to spaces Mar 15, 2016
haskell-repl.el Simplify haskell-interactive-handle-expr Apr 24, 2016
haskell-sandbox.el fix typos in documentation strings Jan 10, 2016
haskell-session.el Use setq-local and defvar-local Apr 9, 2016
haskell-sort-imports.el Convert all tabs to spaces Mar 15, 2016
haskell-string.el fix typos in documentation strings Jan 10, 2016
haskell-unicode-input-method.el globally: turn on lexical bindings Aug 23, 2015
haskell-utils.el Use setq-local and defvar-local Apr 9, 2016
haskell.el Put cursor in the echo area at prompt restart May 1, 2016
highlight-uses-mode.el Use setq-local and defvar-local Apr 9, 2016
inf-haskell.el Use setq-local and defvar-local Apr 9, 2016
logo.svg Use notifications.el rather than notify.el (as it ships with Emacs) Aug 8, 2012
w3m-haddock.el fix typos in documentation strings Jan 10, 2016

README.md

Haskell Mode for Emacs

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

Coverage Status Build Status Melpa Status Melpa Stable Status Latest Docs 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

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!

Something went wrong with that request. Please try again.