Emacs mode for Haskell
Emacs Lisp Makefile
Pull request Compare This branch is 1020 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
Makefile
NEWS
README.md
ghc-core.el
ghci-script-mode.el
haskell-align-imports.el
haskell-bot.el
haskell-cabal.el
haskell-checkers.el
haskell-collapse.el
haskell-commands.el
haskell-compat.el
haskell-compile.el
haskell-complete-module.el
haskell-customize.el
haskell-debug.el
haskell-decl-scan.el
haskell-doc.el
haskell-font-lock.el
haskell-indent.el
haskell-indentation.el
haskell-interactive-mode.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-package.el
haskell-presentation-mode.el
haskell-process.el
haskell-repl.el
haskell-sandbox.el
haskell-session.el
haskell-simple-indent.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 Logo

Haskell Mode for Emacs

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

Build Status Melpa Status Melpa Stable Status

Installation

haskell-mode is best installed as a package.

To install haskell-mode you need to add a package archive repository that distributes haskell-mode. Execute

M-x customize-option RET package-archives

and add

Archive name: melpa-stable
URL or directory name: http://stable.melpa.org/packages/

Fetch list of packages with

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.

You need to enable indentation as this does not happen automatically currently. Add this line to your ~/.emacs file:

(add-hook 'haskell-mode-hook 'haskell-indentation-mode)

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 versions 23, 24 and upcoming 25 (snapshot).

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.

Emacs23 requires an the use of "cl-lib". cl-lib.el can be found in the tests/compat directory. Copy cl-lib.el to your emacs directory, e.g. ~/.emacs.d directory and put

(add-to-list 'load-path "~/.emacs.d/")
(require 'cl-lib)

in your .emacs file.

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 activelly seeking contributions from users of haskell-mode. For more information have a look at the wiki page on contributing.

Getting in contact

Have fun!