TakeV/spacemacs
Archived
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
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
History
Eivind Fonn 08561d8631 core: implement :depends for package declarations 
This replaces the older pattern
:toggle (configuration-layer/package-usedp ..)

This implementation ensures that :disabled-for honors dependent packages, i.e.
if package a depends on package b, which is owned by layer c, and layer c is
disabled for layer d, then neither package a nor b will be configured for layer
d. Previously, this was only true for package a, but not b.

This commit also fixes:

- configuration-layer/describe-package now shows which post-init and pre-init
  functions are disabled, if any
- Does not recreate all layer objects unconditionally when calling
  configuration-layer/discover-layers. Previously, this led to all layers being
  recreated after e.g. `SPC h SPC`, without any of the dotfile information.
  Since this information is now necessary for
  configuration-layer/describe-package, it’s important that we don’t clear the
  indexed layers when invoking this function.
2017-06-22 11:53:05 +02:00
..
img
config.el Bump year in copyright headers 2017-01-05 23:08:17 -05:00
funcs.el dash: make if more idiomatic 2017-05-18 23:12:56 -04:00
packages.el core: implement :depends for package declarations 2017-06-22 11:53:05 +02:00
README.org update docs to the new toc-org format 2017-05-22 18:35:37 +03:00

README.org

Dash layer

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

/TakeV/spacemacs/media/commit/08561d8631153cee93c7348adb515aa217b5df7f/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.