Re: [Qemu-devel] [RFC] [PATCHv6 05/16] aio / timers: Split QEMUClock into QEMUClock and QEMUTimerList

[Stefan Hajnoczi]

On Tue, Aug 06, 2013 at 02:16:02PM +0100, Alex Bligh wrote:
> --On 6 August 2013 14:26:33 +0200 Stefan Hajnoczi
> <address@hidden> wrote:
> 
> >Please use doc comments (see include/object/qom.h for example doc
> >comment syntax).
> 
> Should these go in the .h (per include/qom/object.h) or the .c (per
> your comment)?

I don't think there is a strict rule.

I like putting doc comments in the .c file for non-external APIs.  That
way it's easier to remember that the doc comment needs to be updated if
the function is modified.

Stefan