Generate link to free/unref function for return values and out arguments which transfer ownership
Submitted by Evan Nemerson
Link to original bug (#683361)
Description
It is currently common practice to add comments to out arguments and return values to "free with #whatever_free". This works for C, but it is very confusing for people using languages with automatic memory management (Vala, Python, JS, etc.). Now that those languages are beginning to rely on gtk-doc comments via GObject Introspection for documentation, it seems like a good idea to remove those bits from the comments and have gtk-doc generate similar information automatically so that languages for which such statements are irrelevant don't have to include them.