[Bug 35117] Make gtk-doc nicer

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=35117

Jonny Lamb <jonny.lamb at collabora.co.uk> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
  Status Whiteboard|review-                     |

--- Comment #2 from Jonny Lamb <jonny.lamb at collabora.co.uk> 2011-03-09 03:25:20 PST ---
(In reply to comment #1)
> I think the parenthetical statement confuses more than it adds.

Okay, removed.

> Just annotate the whole body as /*< private >*/.

Yes, why didn't I do that before? Done.

> Actually do that plz, and add the URL to the comment.

Done. I naively cloned the gtk-doc repository but that's as far as I got...

> + * @override_type: %TRUE whether this error should override the error
> + *   in @specializes, or %FALSE
> 
> This comment is wrong: this field signifies whether the following field, @type,
> should be used, or whether the default error type for @specializes should be
> used.

Ah, I see.

All updated and pushed.

-- 
Configure bugmail: https://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.