Skip to content
This repository

Emacs incremental completion and selection narrowing framework

Merge pull request #477 from russell/helm-log-eval

Declare helm-log-eval before using it
latest commit 219b31a85a
Thierry Volpiatto thierryvolpiatto authored
Octocat-spinner-32 doc * doc/Home.mdpp: update. February 22, 2014
Octocat-spinner-32 .gitignore * helm-regexp.el (helm-occur): Fix setting helm-multi-occur-buffer-li… January 29, 2013
Octocat-spinner-32 COPYING Add full GPLv3 license. March 18, 2012
Octocat-spinner-32 Makefile Rename anything prefixes to helm. March 15, 2012
Octocat-spinner-32 README.md * README.md: Update. February 10, 2014
Octocat-spinner-32 emacs-helm.sh * emacs-helm.sh: Use completion-at-point if available. January 01, 2014
Octocat-spinner-32 helm-adaptative.el * helm-adaptative.el (helm-adaptive-sort): Use the real candidate and… January 04, 2014
Octocat-spinner-32 helm-aliases.el * helm-aliases.el (helm-async-be-async): Moved from async and make it… February 19, 2014
Octocat-spinner-32 helm-apt.el * helm-apt.el (helm-apt-cache-show-function): Clarify and use default… February 21, 2014
Octocat-spinner-32 helm-bbdb.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-bookmark.el * helm.el: Add a plugin for keymap to ensure original helm-map is use… April 04, 2014
Octocat-spinner-32 helm-buffers.el Revert commit ab7ffa0 April 04, 2014
Octocat-spinner-32 helm-call-tree.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-color.el * helm-color.el (helm-custom-faces-init, helm-colors-init): Use save-… February 08, 2014
Octocat-spinner-32 helm-command.el * helm-command.el (helm-M-x): Add keymap. April 10, 2014
Octocat-spinner-32 helm-config.el * helm-config.el: Use now helm-filtered-bookmarks by default. March 28, 2014
Octocat-spinner-32 helm-dabbrev.el * helm-dabbrev.el: Reorder defvar on top, avoid warning at compile. February 03, 2014
Octocat-spinner-32 helm-elisp-package.el * helm-elisp-package.el (helm-el-package--init): Reset helm-el-packag… February 10, 2014
Octocat-spinner-32 helm-elisp.el * helm-elisp.el: Fix timer sources and format function (#468). April 01, 2014
Octocat-spinner-32 helm-elscreen.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-emms.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-eshell.el Allow disabling marked candidates. March 27, 2014
Octocat-spinner-32 helm-eval.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-external.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-files.el * helm-files.el (helm-ff-set-pattern): Be sure pattern is a string (#476 April 15, 2014
Octocat-spinner-32 helm-firefox.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-font.el Use with-helm-alive-p in many places and remove autoload cookies wher… January 16, 2014
Octocat-spinner-32 helm-gentoo.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-grep.el * helm-grep.el (helm-do-grep-1): Use now requires-pattern == 2. same … March 12, 2014
Octocat-spinner-32 helm-help.el * helm-command.el (helm-M-x): Add keymap. April 10, 2014
Octocat-spinner-32 helm-imenu.el * helm-imenu.el: bind candidate-number-limit. March 23, 2014
Octocat-spinner-32 helm-info.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-locate.el Remove delayed attr in all sources. January 13, 2014
Octocat-spinner-32 helm-man.el * helm-man.el: Disable persistent-action. January 05, 2014
Octocat-spinner-32 helm-match-plugin.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-misc.el * helm-files.el (helm-source-file-name-history): Use appropriate tran… February 19, 2014
Octocat-spinner-32 helm-mode.el * helm-command.el (helm-M-x): Improve docstring, no code change. April 10, 2014
Octocat-spinner-32 helm-net.el Revert commit ab7ffa0 April 04, 2014
Octocat-spinner-32 helm-org.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-pkg.el * helm-pkg.el: Update version number. April 03, 2014
Octocat-spinner-32 helm-plugin.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-regexp.el Allow saving to grep buffer in m/occur. January 19, 2014
Octocat-spinner-32 helm-ring.el * helm-ring.el: Fix global mark ring. January 10, 2014
Octocat-spinner-32 helm-semantic.el * helm-imenu.el: bind candidate-number-limit. March 23, 2014
Octocat-spinner-32 helm-sys.el Allow disabling marked candidates. March 27, 2014
Octocat-spinner-32 helm-tags.el Additional actions on helm-etags items and keybindings March 28, 2014
Octocat-spinner-32 helm-utils.el * helm-utils.el (helm-yank-text-at-point): Simplify, break newline if… April 05, 2014
Octocat-spinner-32 helm-w3m.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm-yaoddmuse.el Update copyrights. January 02, 2014
Octocat-spinner-32 helm.el Declare helm-log-eval before using it April 15, 2014
README.md
 _____                            _   _      _
| ____|_ __ ___   __ _  ___ ___  | | | | ___| |_ __ ___
|  _| | '_ ` _ \ / _` |/ __/ __| | |_| |/ _ \ | '_ ` _ \
| |___| | | | | | (_| | (__\__ \ |  _  |  __/ | | | | | |
|_____|_| |_| |_|\__,_|\___|___/ |_| |_|\___|_|_| |_| |_|

Abstract

Helm is incremental completion and selection narrowing framework for Emacs. It will help steer you in the right direction when you're looking for stuff in Emacs (like buffers, files, etc).

Helm is a fork of anything.el originaly written by Tamas Patrovic and can be considered to be its successor. Helm sets out to clean up the legacy code in anything.el and provide a cleaner, leaner and more modular tool, that's not tied in the trap of backward compatibility.

Requirements

You need a recent Emacs to use latest helm, at least Emacs-24.3.

Getting Started

Quick install

  1. Clone the helm repository to some directory:

    $ git clone https://github.com/emacs-helm/helm.git /path/to/helm/directory
    
  2. Run make from this directory.

  3. Add to .emacs.el (or equivalent):

    (add-to-list 'load-path "/path/to/helm/directory")
    (require 'helm-config)
    

Alternatively, you can have a quick try to helm by launching from the helm directory:

./emacs-helm.sh

Note that this will not work on Windows systems.

Install from Emacs packaging system

Helm is now available on Melpa at http://melpa.milkbox.net/ You will find there instructions to install.

WARNING: For any upgrade after Version 1.5.6 using package.el, you will have to remove all your helm*.elc files and recompile from a clean Emacs, expect failures if you don't do that. Users that are installing from git will not have this problem by recompiling their helm copy with "make".

Note to Linux Distributions Maintainers

Only the extensions present in the github emacs-helm organisation are supported.

Alternate install warning

Some people are installing helm with their own config using diverses require, autoload and other hacks, not using helm-config. Expect failures and slowdown at startup unless you really know what you are doing when you do so.

Emacs Prelude

If you're afraid to play with Emacs's configuration, but want to try out Helm - have NO FEAR. Have a look at Emacs Prelude - it has Helm built-in and properly set-up.

Basic usage

Just type M-x helm-mini and enjoy. You might want to bind that command to a keyboard shortcut. Here's a suggestion:

(global-set-key (kbd "C-c h") 'helm-mini)

You can also start with M-x helm-mode and enjoy helm completion in your favourites Emacs commands (e.g M-x, C-x C-f, etc...). You can enable this by adding in your init file:

(helm-mode 1)

As a startup point you can also look at the helm section in Emacs menu to discover some of the commands provided by helm.

Advanced usage

Helm is capable of a lot.

You can find all the gory details on the Helm Wiki.

Known issues

Check out the project's issue list a list of unresolved issues. By the way - feel free to fix any of them and sent us a pull request. :-)

Contributors

Here's a list of all the people who have contributed to the development of Helm.

Bugs & Improvements

Bug reports and suggestions for improvements are always welcome. GitHub pull requests are even better! :-)

NOTE: When trying if something is working or not, be sure to start helm from Emacs -Q or even better Start it from your helm directory with ./emacs-helm.sh.

Getting help

If Helm Wiki is not enough, you can ask for help on emacs-helm google group.

Cheers,
The Helm Team

Something went wrong with that request. Please try again.