dash-docs-el / helm-dash

Browse Dash docsets inside emacs
511 stars 59 forks source link

Install docsets from init file #38

Closed jwintz closed 10 years ago

jwintz commented 10 years ago

Is it possible to install docsets directly from within the init file, e.g.:

(require 'helm-dash) (helm-dash-install-docset "Qt_5") (helm-dash-install-docset "...") (helm-dash-install-docset "...")

kidd commented 10 years ago

Nope, As it is now, it's not possible to install docsets automatically (unattended). The change is easy, so we might include it in the future.

jwintz commented 10 years ago

Just tried your branch and it works great, together with (setq helm-dash-docsets-path "~/.emacs.d/docsets"), which closes #39 for a good reason. Thanks for being so fast !

However, it seems to me that this patch does not check for the actual presence of the docset, and therefore, all docsets specified in emacs init get downloaded each time Emacs starts ...

kidd commented 10 years ago

yeah, the purpose of helm-dash-install-docset is both installing and also updating, so I'm afraid we won't support it...

But it's a good place to hack something like defadvice (if you don't care about the updating), or just checking if the files exist in another function, and call install if not. if you do something like that, please come back and put it in the wiki.

jwintz commented 10 years ago

I would have split install and update since both of them is quite time consuming (not to mention the lack of feedback to the user, instead of having "contacting sanfrancisco.kapeli.com", it would be great to have a wget-like progression bar ;-)).

helm-dash-install-docset would be useful interactively or during initialization. helm-dash-update-docset would only be useful interactively.

The pull request for helm-dash-install-docset is IMHO useful anyway but using this function from within an init file needs additional work, as you said.

I'll write some hooks and update the wiki.

Thanks Raimon.