After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 661165 - Update links for Python bindings on developer.gnome.org/references
Update links for Python bindings on developer.gnome.org/references
Status: RESOLVED FIXED
Product: website
Classification: Infrastructure
Component: developer.gnome.org
current
Other Linux
: Normal major
: ---
Assigned To: GNOME Web maintainers
GNOME Web maintainers
Depends on:
Blocks:
 
 
Reported: 2011-10-07 10:37 UTC by André Klapper
Modified: 2017-12-23 14:59 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Add external entries for the PyGObject docs and API reference; Mark pygobject/pygtk as deprecated (2.35 KB, patch)
2017-11-30 23:02 UTC, Christoph Reiter (lazka)
committed Details | Review

Description André Klapper 2011-10-07 10:37:58 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
Comment 1 André Klapper 2011-10-07 10:41:46 UTC
(In reply to comment #0)
> * PyGTK Reference Manual [more versions, languages, or options...] 

could be moved to http://developer.gnome.org/deprecated maybe
Comment 2 André Klapper 2011-10-07 11:05:03 UTC
<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
Comment 3 Christoph Reiter (lazka) 2017-09-03 10:39:05 UTC
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/
Comment 4 Christoph Reiter (lazka) 2017-11-30 23:02:17 UTC
Created attachment 364705 [details] [review]
Add external entries for the PyGObject docs and API  reference; Mark pygobject/pygtk as deprecated
Comment 5 Frederic Peters 2017-12-07 22:07:30 UTC
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).
Comment 6 Christoph Reiter (lazka) 2017-12-08 16:05:21 UTC
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?
Comment 7 Christoph Reiter (lazka) 2017-12-12 09:48:34 UTC
Can I push this?
Comment 8 Christoph Reiter (lazka) 2017-12-23 14:17:53 UTC
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.
Comment 9 Christoph Reiter (lazka) 2017-12-23 14:59:49 UTC
The result on https://developer.gnome.org/references#python-bindings and https://developer.gnome.org/deprecated looks as indented, so I'm closing this.