[Webkit-unassigned] [Bug 167495] [GTK] Confusing webkit_uri_scheme_request_finish_error() description

[bugzilla-daemon at webkit.org]

https://bugs.webkit.org/show_bug.cgi?id=167495

--- Comment #3 from Michael Catanzaro <mcatanzaro at igalia.com> ---
I don't think it's desirable to mention in freeform documentation whether you have to free a variable when we already use a structured unambiguous annotation language to describe that. I agree that it is confusing if you're not familiar with the rules for defaults; I have to look them up semi-regularly myself. gtk-doc could be improved to explicitly indicate default annotations in order to avoid such confusion.

As for const, we normally only use const to indicate ownership of char* strings.

-- 
You are receiving this mail because:
You are the assignee for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.webkit.org/pipermail/webkit-unassigned/attachments/20170130/eca94931/attachment.html>