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/README.org
2016-10-23 19:44:35 +02:00

3.1 KiB

Dash layer

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

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

Description

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.

Sqlite3

Helm Dash requires sqlite3 to be installed to function properly.

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 or counsel-dash
SPC d H Lookup in helm-dash or counsel-dash within a specified Docset

helm-dash and counsel-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 when using helm and counsel-dash when using ivy, which requires no additional application. You can use dash/helm-dash-docset-newpath to set the location path of your docsets.