Re: Deprecation documentation

[Jonas Platte <mail jonasplatte de>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Am 23.06.2015 um 09:54 schrieb Philip Withnall:
> From my little knowledge of Haskell, your code looks good. However,
> I don’t think this actually works in pygobject.
>
> $ python -Wall  # -Wall to enable deprecation warnings
> > from gi.repository import Gio foo = Gio.Application() 
> > Gio.Application.set_action_group(foo, None)
> __main__:1: DeprecationWarning: Gio.Application.set_action_group
> is deprecated
>
> Looking at Gio-2.0.gir, I would expect to see a deprecation
> message starting with “Use the #GActionMap interface instead”.
>
> As far as I remember, deprecation documentation is not copied into
> the .typelib file, which is what GIRepository uses; so it’s not
> available to the GBaseInfo. This is the underlying problem.
>
> In fact, there’s a bug report about it:
>
> https://bugzilla.gnome.org/show_bug.cgi?id=694728
>
> Philip

Alright. I just found out that the documentation I was looking at
which had the deprecation reasons is generated by a completely
different program, pgi-docgen, for pgi and not pygobject, though those
might have the same or at least a very similar API.

I'll see if I can find out how that program reads the deprecation
docs, but I guess it will come down to parsing the .gir file manually...

Thanks for pointing out the bug report though.

Jonas

[1] https://github.com/lazka/pgi-docgen

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iQEcBAEBCAAGBQJViTbcAAoJEChniccSSv3rkRkH/3AbHjljZzJ4zwccS87C3wRc
MqODR5YmDXZDJp//Se/9TWDQSYE6QUCsh4Cy2BpXHehp+K2eL6hkCGwM/gjfcIUq
Rxg9ootEEnf+9SbiGtTwgLSELhxQqYCdZ5SbDEEavE/si5wsfjCr7mr9RsrSdB1x
hxhLwZUlLWUoh0blXi75cwtlpc42EiDugBqtdGywsLjBXr0S/AFBwC63+Jb0+oIS
WVwJnWXYLy9WaHseJ+fgfywY8mRIgIFJG7FMnUKNgxt09uz24bS/QVPlWSCstnGO
LafauJ0t3S+zKkJZ99t7ce4c7u6b1gsqfPLi0+CrPiRybB/i8v/pwPnsB5CHe2A=
=ORRH
-----END PGP SIGNATURE-----