Provide a way to install the generated docset about cargo-docset HOT 8 OPEN

The documentation for dash doesn't mention that a restart is needed, I will try this on my mac later.

from cargo-docset.

To make things a little faster I hacked up a little shell script to automate the creation/installation of a docset on Zeal with cargo-docset, might be useful: gist link

from cargo-docset.

Also, if anyone passing by happens to run dash and can share any insight: does dash need to be restarted to pick up the new docset after replacing it? I would think so, but I don't own a mac to try it.

from cargo-docset.

Thank you!

I just realized the issue description does not fully describe my concern. So, to be clear, the part I'm worried about is whether dash detects the new SQLite database after copying a new version of an existing docset, or if it's just loaded at startup and kept in memory. In other words, if you copy an updated docset containing new entries (as opposed to just updating the contents of previously existing pages), are these new entries detected when searching from within dash without restarting it.

from cargo-docset.

Sorry it took so long, just got the chance to do this. Tested it with one crate, edited the documentation of the main package, and reloading was only required when I navigated away and back to that section.

from cargo-docset.

Sorry it took so long

No problem, that was actually pretty darn quick 😄 In any case, I won't be working on this right away, hopefully next week, so there really is no rush.

Thank you for the testing! So if I understand correctly, Dash does behave the same as Zeal here, and needs a restart before it can use the updated SQLite database, correct ? If so, then we can treat Dash and Zeal pretty much the same in cargo-docset. And if that's the case, then, excellent, the less platform/doc browser specific code, the better.

from cargo-docset.

Sorry it took so long ...

@Robzz No restart, just need to navigate away and back, sorry I didn’t word that well.

from cargo-docset.

I build the docset for the project I worked on in GHA, and created a RSS feed, which contains all dependencies' docs. It can be subscribed via an url like dash-feed://https%3A%2F%2Frisingwavelabs.github.io%2Frisingwave%2FRisingWave.xml 😄

https://github.com/risingwavelabs/risingwave/blob/461c4eb131eb83fb7b916b00215288abab29c354/.github/workflows/doc.yml#L37-L47

from cargo-docset.