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
syl20bnr ebe4c60264 Revert "Defer packages by default using use-package-always-defer" 
This reverts commit 29c78ce841 and all other fixes
that have been made afterwards.

The motivation is that use-package is seen by many as a replacement for
`require`. Is use-package always defer the loading of packages then is breaks
this use case, this does not respect POLA so even if it was making Spacemacs
loading faster (up to 3s faster on some startup on my machine) we just cannot
use it, it would be irresponsible. Spacemacs should be easy to use, loading
performance will come with time but it is not a priority.
2018-03-03 23:40:10 -05:00
..
img
config.el Happy New Year 2018! 2018-01-04 02:00:25 -05:00
funcs.el Happy New Year 2018! 2018-01-04 02:00:25 -05:00
packages.el Revert "Defer packages by default using use-package-always-defer" 2018-03-03 23:40:10 -05:00
README.org Fix doc for nim, fsharp, forth, dash and fasd layer 2018-01-08 01:45:09 -05:00

README.org

Dash layer

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

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

Description

This layer integrates offline api browsers into emacs. It provides one for OS X, Linux and Windows.

Features:

  • Searching for word at point in offline api browser's UI.
  • Integration of offline api browser search results in helm and ivy.
  • Support for dash offline api browser for OS X.
  • Support for zeal offline api browser for Linux.

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

Word at point

dash-at-point and zeal-at-point will search for the word at point in the respective offline api browser. The result will be displayed in the offline browser's UI.

However having to leave emacs to have a look at the search results may be a bit awkward. To help with this it is also possible to integrate the search results directly in helm or ivy and show the details in a browser. To do so helm-dash can be used for helm and counsel-dash for ivy.

To get them working it is necessary to set helm-dash-docset-newpath to the location of your docsets.

  (dash :variables
        helm-dash-docset-newpath "~/.local/share/Zeal/Zeal/docsets")

For more details please check dash-at-point-usage or zeal-at-point.

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