Re: On having gtk-doc documentation enabled in a bindings release

[Tomeu Vizoso <tomeu vizoso collabora co uk>]

Hi Adam,

On Wed, May 26, 2010 at 14:10, Adam Plumb <adamplumb gmail com> wrote:
> hi all, I hope this is a correct place for this question.  I'm the
> maintainer for the nautilus-python bindings and have recently made a
> release that is gtk-doc enabled.  Meaning, when you add
> --enable-gtk-doc to configure/autogen.sh, it generates html
> documentation and installs it to the standard gtk-doc folder on your
> computer.
>
> I'd like to have gtk-doc enabled whenever I do an official release,
> but I can't seem to get it to work.  If I do:
>
> $ sh autogen.sh --enable-gtk-doc && make && make install && make distcheck
>
> then that generates the docs but doesn't install the html files into
> the tarball.

haven't tried that myself, If I had to debug it I would go to
docs/Makefile and see if there's anything different about installing
when compared to the one at pygtk.

That I know, the maintainers of pygobject/pygtk are not in this list.
You could try in http://www.daa.com.au/mailman/listinfo/pygtk but I
haven't had luck in the past with such questions.

Cheers,

Tomeu

> FYI, the only python bindings project I've seen that distributes its
> tarball with the html docs is pygobject (and maybe pygtk, not sure),
> and I can't figure out what they are doing that I'm not doing.  Should
> I change the command above somehow, or is it some setting in
> configure.ac/Makefile.am?
>
> Here is the source code: http://git.gnome.org/browse/nautilus-python/
>
> Thanks,
> Adam
> _______________________________________________
> python-hackers-list mailing list
> python-hackers-list gnome org
> http://mail.gnome.org/mailman/listinfo/python-hackers-list
>