GNOME Bugzilla – Bug 322033
ATK tarball has no list of deprecated functions.
Last modified: 2006-06-28 14:44:24 UTC
GTK+ uses gtk-doc to mark deprecated functions, like so: http://developer.gnome.org/doc/API/2.0/gtk/ix02.html ATK+ doesn't seem to do this: http://live.gnome.org/AddedDeprecatedInterfaces#head-1fa86c7dc379f56d175843b0b8657cff0930c5fc It would be nice if it did. See also http://bugzilla.gnome.org/show_bug.cgi?id=313183 about the "since" tag.
SO far there aren't any deprecated functions in ATK.
So is this list wrong?: http://live.gnome.org/AddedDeprecatedInterfaces#head-1fa86c7dc379f56d175843b0b8657cff0930c5fc
Yes, very wrong. Where did that list come from?
Murray - I have edited that Wiki page. I'll have a root around to see if I've forgotten any deprecations.
> Where did that list come from? Brian Cameron, I think.
Brian's right, I just mis-read the wiki doc. I didn't even know those symbols had ever existed! However, they are marked as deprecated (already) in gtk-doc. I guess this RFE is for a "list of deprecated symbols", I am cluing in now. I have, however, no idea how to do this, since we're already using the 'deprecated' tag.
reopening as RFE, since there doesn't appear to be a list autogenerated from the 'deprecated' gtk-doc tags. Can anyone point me to a doc on how to do that?
Overheard in irc: <tko> I'm trying to build API docs for maemo modified gtk+ and on the surface the docs get built, but on closer look I can see at least deprecated symbols and lists of new symbols being missing from the table of contents <tko> can't help but I just have this feeling no one really knows how to use gtk-doc, everyone just copypastes something that seems to work <mclasen> tko: you need to add suitable <index/> elemnts to your main document <tko> mclasen, I have whatever was in 2.6.10 but even those disappear <mclasen> tko: see gtk-docs.sgml for an example <tko> any specific gtk-doc version that's required? <mclasen> tko: could be that your docbook style sheets are old <mclasen> tko: the multi-index support that was added as some point was a patch by me to get gtk-doc support for multiple indices <tko> hmm.. I have gtk-doc-tools 1.3 and docbook-xml 2.0.3 from debian.. ring a bell? :-]
Ok, with the following it worked for me: gtk-doc-tools 1.4 docbook-xml 4.3 docbook-xsl 1.68.1 <-- this was important, 1.64 was too old And then the <index role="deprecated"> ... </index> works If you use both @deprecated and Since: tags, such as: * Since: egg 2.2 * @Deprecated: use foo instead only index like <index role="deprecated egg 2.2">...</index> will collect the symbol (role="deprecated" and role="egg 2.2" both will fail to include it)
OK, so this is some kind of tools issue with creating tarballs, not a problem with the cvs ATK sources.
I've got docbook-xml 4.4, docbook-xsl 1.69.1, gtk-doc from HEAD... and it still doesn't work.
See bug 313183, this was the same issue, only a different tag. Fixed in CVS, will be fixed in the next ATK tarball. *** This bug has been marked as a duplicate of 313183 ***