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

Gtk.Template missing in Object API Reference

Open osamuaoki opened this issue 3 years ago • 0 comments

Thank you for updating PyGObject Docs » User Guide » Gtk.Template . This really helped. Thanks.

To learn more, I looked for Object API Reference and didn't find Gtk.Template there:

  • https://lazka.github.io/pgi-docs/#Gtk-3.0/mapping.html

Since this Gtk.Template is implemented as an override decorator class and doesn't have a normal mapped C function, this may well be expected from your POV.

Can you at least consider to add a short pointer-like footnote to "This is implemented for Python by PyGObject with Gtk.Template." as something like: This Gtk.Template is a decorator class is implemented as override in python3-gi in /usr/lib/python3/dist-packages/gi/overrides/Gtk.py. So Gtk.Template doesn't show up in Object API Reference. It's content is available at /usr/lib/python3/dist-packages/gi/_gtktemplate.py.

Of course, API reference covering Gtk.Template is better but may not be trivial (I don't know).

osamuaoki avatar Jul 07 '21 01:07 osamuaoki