Hanna for gems

In case I need to do this again (and again)

Hanna makes gems’ documentation much better: the layout is less obtrusive and the method finder is most helpful indeed.

But I forget how to “install” it as the default RDoc template.

From github.com/mislav this:

Another neat trick is to put the following line in your .gemrc:

rdoc: --inline-source --line-numbers --format=html --template=hanna

This will make RubyGems use Hanna when generating documentation for installed gems.

So let’s try it on ashgrove. Meh, perhaps sudo hanna --gems ancestry worked and Firefox is just caching the old layout. Whatever, the Ancestry RDocs from gemserver still looks the same so this:

sudo hanna --gems

Should re-rdoc all of ‘em and so far it looks like it’s working.

Update It may be that the noisiness of gem server running in the same terminal session was ‘messing up’ the re-generation of RDocs. Shrug.

Update Nope. That same old bullshit of having two gem sources on the same machine. I understand the how and why but regret the occasional aggravating confusion that is inevitable when one serves two masters.

Maybe now I can get on with looking at the many methods that Ancestry provides….