pgi-docgen icon indicating copy to clipboard operation
pgi-docgen copied to clipboard

A bit of doc update, and HarBuzz built from source example

Open HinTak opened this issue 6 years ago • 5 comments

The "gir-1.0" is not obvious - I needed to run strace to figure that out.

HinTak avatar Oct 04 '18 23:10 HinTak

I want to write a bit about virtualenv also, please don't pull yet.

HinTak avatar Oct 04 '18 23:10 HinTak

I can't seem to figure out how to do `pwd` (for the pythonpath part), but this is all I wanted to write. Please review and pull.

HinTak avatar Oct 05 '18 00:10 HinTak

somewhat related: I've filed #173

lazka avatar Oct 06 '18 17:10 lazka

Actually pgi-docgen's installation was not not too bad. I was reluctant to run tools/bootstrap.sh for a long time fearing it would download lots of stuff. It only put about 20MB on my hard disk.

Running it was more an issue - as you saw, it took me a bit of time to figure out how to regenerate HarfBuzz's doc from dev source (after I made some gobject annotation changes); the cert package situation was curious though understandable - the packager wants you to use the code but not the bundled certificates (which can get out of date). I also was not expecting it to recurse through my system's GIR directory and regenerating dependent packages' docs when I only asked for one.

As far as this pull goes, I think your only objection is the pythonpath one? I think it is not ideal either, and I like to figure out what's wrong if there is any tips in looking into that.

HinTak avatar Oct 06 '18 21:10 HinTak

Apologies, been a while. I'll come back to this and see if there is any more work to be done soon...

HinTak avatar Dec 03 '20 19:12 HinTak