GNOME Bugzilla – Bug 650118
Extend documentation about the AtkHyperlink class and the AtkHyperlinkImpl interface
Last modified: 2021-06-10 11:25:38 UTC
At the moment, even though the AtkHyperlink class and AtkHyperlinkImpl interface are already documented through gtkdoc, I kind of miss some deeper explanation on why the design was done like this instead of, for example, just defining an AtkHyperlink interface that would be implemented by the proper AtkObjects. After talking to Fer Herrera in the ATK/AT-SPI Hackfest 2011, it seems this could be due to the not willing to break ABI compatibility back when it was decided it would be needed to implement something like this in ATK (see bug [1]), So, wrapping up, the point of this bug would be to extend documentation to better explain why that design and how it should be used, so people using it could save some time :) [1] https://bugzilla.gnome.org/show_bug.cgi?id=344284
[Mass-reassigning open atk bug reports for better trackability as requested in https://bugzilla.gnome.org/show_bug.cgi?id=653179 . PLEASE NOTE: If you have watched the previous assignee of this bug report as a workaround for actually getting notified of changes in atk bugs, you yourself will now have to add atk-maint@gnome.bugs to your watchlist at the bottom of https://bugzilla.gnome.org/userprefs.cgi?tab=email to keep watching atk bug reports in GNOME Bugzilla. Sorry for the noise: Feel free to filter for this comment in order to mass-delete the triggered bugmail.]
(In reply to comment #0) > At the moment, even though the AtkHyperlink class and AtkHyperlinkImpl > interface are already documented through gtkdoc, I kind of miss some deeper > explanation on why the design was done like this instead of, for example, just > defining an AtkHyperlink interface that would be implemented by the proper > AtkObjects. > > After talking to Fer Herrera in the ATK/AT-SPI Hackfest 2011, it seems this > could be due to the not willing to break ABI compatibility back when it was > decided it would be needed to implement something like this in ATK (see bug > [1]), > > So, wrapping up, the point of this bug would be to extend documentation to > better explain why that design and how it should be used, so people using it > could save some time :) > > [1] https://bugzilla.gnome.org/show_bug.cgi?id=344284 Due bug 684665 I moved several documentation stuff, including and extra explanation about why AtkHyperlink and AtkHyperlinkImpl were modeled as were modeled, that existed before as a comment at the code. Please take a look and comment is that is enough in order to close the bug. Having said so, current status just sucks, something that we already mentioned (with nicer words) at bug 650122 created also by you.
GNOME is going to shut down bugzilla.gnome.org in favor of gitlab.gnome.org. As part of that, we are mass-closing older open tickets in bugzilla.gnome.org which have not seen updates for a longer time (resources are unfortunately quite limited so not every ticket can get handled). If you can still reproduce the situation described in this ticket in a recent and supported software version of atk, then please follow https://wiki.gnome.org/GettingInTouch/BugReportingGuidelines and create a ticket at https://gitlab.gnome.org/GNOME/atk/-/issues/ Thank you for your understanding and your help.