search

dash-docs-el / helm-dash

Browse Dash docsets inside emacs
511 stars 59 forks source link

Support multiple search paths #71

Open lvh opened 9 years ago

lvh commented 9 years ago

Right now helm-dash supports a single path for finding docsets, but Dash uses multiple internally:

~/L/A/Dash: ls                                                          16:42:01
Cheat Sheets      Java DocSets      Temp              library.dash
DocSets           License           Versioned DocSets
kidd commented 9 years ago

how does it recognize the nested directories? or it's just one level more deep?

so, it'd be '.docsets/ * /' or '.docsets/ * * / * ' ? the latter is much more difficult that the former

areina commented 9 years ago

Hey @lvh , I'm a linux user and I have no idea how Dash manages its folders internally, sorry. It looks like you should point helm-dash-docsets-path to ~/L/A/Dash/DocSets but I can't confirm that. @tko @Kapeli could you help with this, please? Thanks!

Kapeli commented 9 years ago

Dash doesn't have a "docset folder". It installs docsets in different folders depending on the source and it works with them individually. Users can also add docsets from arbitrary locations/folder.

~/L/A/Dash/DocSets is the location where the main docset repo installs docsets. The main docset repo is the one with the docsets listed at http://kapeli.com/docset_links. These are pretty much the docsets generated and maintained by me.

However, Dash also has 9 other docset sources:

  1. Cheat Sheets. Installed in ~/L/A/Dash/DocSets/Cheat Sheets
  2. Cocoa Docsets. Installed in ~/L/A/Dash/DocSets/Cocoa DocSets
  3. Ruby Docsets. Installed in ~/L/A/Dash/DocSets/Ruby DocSets
  4. Java Docsets. Installed in ~/L/A/Dash/DocSets/Java DocSets
  5. Scala Docsets. Installed in ~/L/A/Dash/DocSets/Scala DocSets
  6. PHP Docsets. Installed in ~/L/A/Dash/DocSets/PHP DocSets
  7. Go Docsets. Installed in ~/L/A/Dash/DocSets/Go DocSets
  8. Stack Overflow. Installed in ~/L/A/Dash/DocSets/Stack Overflow
  9. User Contributed. Installed in ~/L/A/Dash/DocSets/User Contributed

Also, versioned docsets coming from all docset sources are installed in ~/L/A/Dash/Versioned DocSets.

Further docset sources will be added to Dash in the future. The best bet would be to */*/*.docset in ~/L/A/Dash

areina commented 9 years ago

Thanks @Kapeli for the info