|
From: | Alex Bligh |
Subject: | Re: [Qemu-devel] [RFC] [PATCHv7 01/22] aio / timers: Add qemu_clock_free and expose qemu_clock_new and clock types |
Date: | Wed, 07 Aug 2013 12:37:10 +0100 |
--On 7 August 2013 13:31:07 +0200 Stefan Hajnoczi <address@hidden> wrote:
Regarding doc comments: if the function is self-documenting then the doc comment might not add much. I think in those cases it's okay to omit details about arguments or return values if they are clear from the function prototype.
Given I've done them for every function, I hope they don't cause any active harm. I was concerned that with an API change some things that one might have thought were obvious are in fact not obvious (e.g. timer_del vs. timer_free). -- Alex Bligh
[Prev in Thread] | Current Thread | [Next in Thread] |