----- Original Message ----- > From: "Fam Zheng" <[email protected]> > To: "Stefan Hajnoczi" <[email protected]> > Cc: "John Snow" <[email protected]>, "Peter Maydell" > <[email protected]>, "QEMU Developers" > <[email protected]>, "Stefan Hajnoczi" <[email protected]>, "Paolo > Bonzini" <[email protected]> > Sent: Thursday, November 10, 2016 4:39:14 AM > Subject: Re: [Qemu-devel] Sphinx for QEMU docs? (and a doc-comment format > question) > > On Wed, 11/09 11:32, Stefan Hajnoczi wrote: > > No doc comments -> error. > > I'm not sure that is a good idea. For example all .bdrv_co_flush_to_disk > implementations have the same semantics and signature, requiring doc comments > everywhere might be too much.
The check would be only on specific files. However, I find it hard to implement it if we place doc comments for types in headers and those for functions in .c files (with automatically generated docs, most of the advantages of doc comments in headers go away). Paolo
