feiyongzhai / fasd

Emacs integration for the command-line productivity booster `fasd'

Home Page:https://framagit.org/steckerhalter/emacs-fasd

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

emacs-fasd

An Emacs extension to integrate Fasd:

Fasd (pronounced similar to “fast”) is a command-line productivity booster. Fasd offers quick access to files and directories for POSIX shells. It is inspired by tools like autojump, z and v. Fasd keeps track of files and directories you have accessed, so that you can quickly reference them in the command line.

Prerequisites

Installation

quelpa

quelpa is at https://github.com/quelpa/quelpa

(quelpa '(fasd :repo "steckerhalter/emacs-fasd" :fetcher github))

Since the recipe is stored in melpa this also works:

(quelpa 'fasd)

Interactively: M-x quelpa fasd RET.

MELPA

You can install fasd.el using the packages on Melpa.

Make sure you have something like the following in your Emacs startup file (~/.emacs.d/init.el, or ~/.emacs):

(add-to-list 'package-archives
             '("melpa" . "http://melpa.milkbox.net/packages/"))

To make that take effect, either evaluate that elisp expression or restart Emacs.

Then use M-x package-list-packages, select fasd from the list by pressing i, then press x to execute the changes. At that point, the package will be installed.

El-Get

Example recipe for el-get:

(:name fasd
       :type github
       :url "https://github.com/steckerhalter/emacs-fasd"
       :depends (grizzl)
       :postinit (progn
                   (global-set-key (kbd "C-h C-/") 'fasd-find-file)
                   (global-fasd-mode 1)))

Usage

Add a shortcut key for fasd-find-file and enable the global-fasd-mode which makes sure that opening files or directories in Emacs updates the fasd database.

(global-set-key (kbd "C-h C-/") 'fasd-find-file)
(global-fasd-mode 1)

Calling fasd-find-file with a prefix argument of

  • C-u lists only directories
  • M-- lists only files

With no prefix it shows files and directories.

Options

Use the customize interface:

M-x customize-group RET fasd RET

Initial Prompt

Usually fasd will prompt for a initial query. To turn that off and get all results directly, set fasd-enable-initial-prompt to nil.

Completion Function

By default the standard completing-read-function will be used, which could be using helm or ido depending on what you are using. To use e.g. ido explicitly set it to ido-completing-read. Previously the default was grizzl-completing-read but the dependency on grizzl has been removed. If you still want to use grizzl, you need to install the package and set the completing-read-function accordingly.

Standard search

By default the fasd search parameter is -a which searches files and directories, you can customize this with the fasd-standard-search option.

About

Emacs integration for the command-line productivity booster `fasd'

https://framagit.org/steckerhalter/emacs-fasd

License:GNU General Public License v3.0


Languages

Language:Emacs Lisp 100.0%