GNOME Bugzilla – Bug 661165
Update links for Python bindings on developer.gnome.org/references
Last modified: 2017-12-23 14:59:49 UTC
1) http://developer.gnome.org/references#python-bindings links to * PyGObject Reference Manual [more versions, languages, or options...] * PyGTK Reference Manual [more versions, languages, or options...] I don't think that we should advertise the latter anymore, or at least put up a warning, as PyGTK-2.24 is the ***final*** major release of PyGTK. 2) http://developer.gnome.org/pygobject lists 2.28.6 as the latest available version for documentation, however http://developer.gnome.org/pygobject/stable provides 2.90.3. Latest is 3.0.1 as per http://ftp.acc.umu.se/pub/GNOME/sources/pygobject/ On the other hand: <nud> the thing is, bindings using introspection do not have generated docs <nud> so I guess binding documentation in library.gnome.org is probably out of date as a whole
(In reply to comment #0) > * PyGTK Reference Manual [more versions, languages, or options...] could be moved to http://developer.gnome.org/deprecated maybe
<tomeu> just to be clear, we do want generated docs for each library and language combination, is just that we don't have them yet
I've tried update/build library-web, but I couldn't find a way to just build the page without it downloading/building the world. I've given up for now. If someone knows how: * pygtk and pygobject can be moved to deprecated * PyGObject documentation is here: https://pygobject.readthedocs.io * Python API docs are here: https://lazka.github.io/pgi-docs/
Created attachment 364705 [details] [review] Add external entries for the PyGObject docs and API reference; Mark pygobject/pygtk as deprecated
I would not mark as "upcoming deprecation" the "PyGObject Reference Manual", instead as the documentation is now hosted elsewhere I would simply skip that module. (add pygobject tarball to the blacklist in src/defaults.lgorc).
Thanks. The gtk-doc version of pygobject documents the old 2.x interface, while the new one the 3.x interface, the old one is for pygtk apps, the new for GI apps. So it's not just hosted somewhere else but a "different" library. Should I still skip it?
Can I push this?
Comment on attachment 364705 [details] [review] Add external entries for the PyGObject docs and API reference; Mark pygobject/pygtk as deprecated I went ahead and pushed this with some additional explanations. If there are any problems feel free to revert and/or ping me.
The result on https://developer.gnome.org/references#python-bindings and https://developer.gnome.org/deprecated looks as indented, so I'm closing this.