<html>
<head>
<base href="https://bugs.webkit.org/" />
</head>
<body>
<p>
<div>
<b><a class="bz_bug_link
bz_status_NEW "
title="NEW - [GTK] Confusing webkit_uri_scheme_request_finish_error() description"
href="https://bugs.webkit.org/show_bug.cgi?id=167495#c2">Comment # 2</a>
on <a class="bz_bug_link
bz_status_NEW "
title="NEW - [GTK] Confusing webkit_uri_scheme_request_finish_error() description"
href="https://bugs.webkit.org/show_bug.cgi?id=167495">bug 167495</a>
from <span class="vcard"><a class="email" href="mailto:mcrha@redhat.com" title="Milan Crha <mcrha@redhat.com>"> <span class="fn">Milan Crha</span></a>
</span></b>
<pre>I do not know how "normal" it is, I only try to keep APIs clean as much as possible, even in C, where the 'const' doesn't propagate to structure members. The hint with 'const' is like to mark a function 'const' in C++. Of course, there are some "issues" sometimes, when the corresponding API doesn't do the same, thus you can end with a silly typecast from const to non-const on an object where its get-function doesn't declare the object as const (and example can be a GSList/GList), though this is hidden to the caller.
I'm fine if you do not want to change it to the 'const', just make it explicit in the documentation that the 'error' is not taken by the function.
I consider confusing also [1], but maybe it's more about no explicit mention that the 'model' is referenced by the GtkTreeView. I understand that it's obvious when one knows about "default transfer method", but I confess I didn't know that.
The closest to this webkit function might be [2], and even it's all deprecated, see the [3], which takes ownership of the 'error', but it's not properly annotated. GTask has this done properly, at least where I looked.
[1] <a href="https://developer.gnome.org/gtk3/stable/GtkTreeView.html#gtk-tree-view-set-model">https://developer.gnome.org/gtk3/stable/GtkTreeView.html#gtk-tree-view-set-model</a>
[2] <a href="https://developer.gnome.org/gio/stable/GSimpleAsyncResult.html#g-simple-async-result-set-from-error">https://developer.gnome.org/gio/stable/GSimpleAsyncResult.html#g-simple-async-result-set-from-error</a>
[3] <a href="https://developer.gnome.org/gio/stable/GSimpleAsyncResult.html#g-simple-async-result-take-error">https://developer.gnome.org/gio/stable/GSimpleAsyncResult.html#g-simple-async-result-take-error</a></pre>
</div>
</p>
<hr>
<span>You are receiving this mail because:</span>
<ul>
<li>You are the assignee for the bug.</li>
</ul>
</body>
</html>