This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/layers/+tools/dash
2016-01-06 00:21:55 -05:00
..
img
config.el
packages.el
README.org Update install layer section in REAMDE.org files 2016-01-06 00:21:55 -05:00

Dash layer

/TakeV/spacemacs/media/commit/bd9ad83f4bc37b296718fdd7f19cba9d8846a926/layers/+tools/dash/img/dash.png

/TakeV/spacemacs/media/commit/bd9ad83f4bc37b296718fdd7f19cba9d8846a926/layers/+tools/dash/img/zeal.png

Description

This layer works only on OS X for the moment

dash
Is a great tool for quick access to various sets of documentation, only available in OS X.
dash-at-point
Is the package used to integrate dash in Emacs. It will try to intelligently guess specific docsets to use based off of your current mode.
zeal
Zeal is an offline documentation browser inspired by Dash, available for Linux and Windows.
zeal-at-point
Run zeal-at-point to search the word at point (or string in region), then Zeal is launched and search the word. Use prefix argument C-u to edit the search string first.

Install

To use this configuration layer, add it to your ~/.spacemacs. You will need to add dash to the existing dotspacemacs-configuration-layers list in this file.

Dash (OS X)

You have to install dash on your machine.

It is recommended to set the HUD mode in your Dash application preferences when using this layer.

Zeal (Linux & Windows)

You have to install zeal on your machine.

Then install the docsets you use more frequently

Check Documentation for x-at-point

See the documentation dash-at-point-usage , or zeal-at-point for more information on customizing specific docsets for modes.

Key bindings

Key Binding Description
SPC d d Lookup thing at point in Dash or Zeal
SPC d D Lookup thing at point in Dash or Zeal within a specified Docset
SPC d h Lookup thing at point in helm-dash
SPC d H Lookup thing at point in helm-dash within a specified Docset

helm-dash

dash-at-point is linked to the GUI app and is only available for OSX. On linux, you can use zeal-at-point which is linked to the GUI app too, but it's open source.

Or you can use helm-dash instead, it requires no app. You can use dash/helm-dash-docset-newpath to set the location path of your docsets.

TODOs

DONE Check zeal

CLOSED: [2015-06-12 Fri 16:30] zeal is an open source alternative to dash with Emacs integration available.

TODO Make helm-dash use zeal or dash docsets by default.