Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feature request: On Mac, automatically install docsets downloaded by Dash application #162

Open
rswgnu opened this issue Sep 7, 2017 · 4 comments

Comments

@rswgnu
Copy link

rswgnu commented Sep 7, 2017

A common scenario might be that a Mac user starts with the Dash application, downloads a bunch of docsets and uses that application. Then he decides he wants Emacs integration, so he installs helm-dash. But then he has no way to utilize those docsets without installing each docset again under helm-dash.

The mechanics to solve this are all already in the helm-dash package. You have the standard directory where Dash installs docsets, the subdirectory where the .tgz is kept and you have a way to install a docset from an existing .tgz file.

So the request is that when helm-dash-common-docsets is nil and docsets can be found, then locally install them (either use or recreate the SQLite database from the .tgz file) and add them automatically to helm-dash-common-docsets.

This would provide a nice out-of-the-box experience for new users who started with Dash rather than the current experience where none of the existing local docsets are seen or utilized.

By the way, helm-dash is great once set up. Thanks for the work.

@kidd
Copy link
Member

kidd commented Sep 8, 2017

Hello,
There is the variable `helm-dash-docsets-path' which tries to be smart and use the original dash's docsets path "~/Library/Application Support/Dash/DocSets". We shouldn't be reinstalling the docset anywhere as we can reuse the files used by dash.

But it's true that there's a second part to having a docset really active, which is have it in helm-dash-common-docsets. Defaulting to * might be an option.

@rswgnu
Copy link
Author

rswgnu commented Sep 8, 2017 via email

@jsmestad
Copy link

jsmestad commented Apr 6, 2019

Came here to request this exact feature. Especially for using docsets that are generated off of npm or hex packages.

@kidd
Copy link
Member

kidd commented Apr 7, 2019

I don't have the original Dash (not even a Mac), so I can't try it for myself...

From the initial description, it seems we already have everything there, we just need an helm-dash-import-from-original-dash-tgzs function that does the plumbing, right?

I thought that dash worked with the untgzed files already so we could just reuse those.

vimpostor added a commit to vimpostor/vim-clue that referenced this issue Aug 29, 2024
Without a Mac it is hard to find out where the docsets live, since it's
not documented anywhere officially. My magic crystalball [0] says that
this is likely the correct path, but we will probably never know if this
actually works.

[0] dash-docs-el/helm-dash#162 (comment)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants