[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH 1/4] memory: make memory API parsable by gtkdoc-
From: |
Peter Maydell |
Subject: |
Re: [Qemu-devel] [PATCH 1/4] memory: make memory API parsable by gtkdoc-scan |
Date: |
Wed, 14 Dec 2011 17:11:29 +0000 |
On 14 December 2011 16:55, Anthony Liguori <address@hidden> wrote:
> I think in this case, we're just going to have to deviate from the standard.
> The benefit is great, the practice is widespread, and there's no immediate
> likelihood of changing glib's coding style practices.
>
> I still think we should adhere to this policy where ever possible but I
> think we'll have to make an exception for extracting documentation.
Disagree. A docs tool that requires us to change our coding/naming
conventions (as opposed to merely how we mark stuff up in comments
or whatever) is a broken tool. Doubly so if it mandates violation
of the C standards.
We want to be able to document the structs/whatever we have now,
not only after we've done some enormous change to every struct we
have to bring it into line with somebody else's conventions.
-- PMM
[Qemu-devel] [PATCH 3/4] memory: update documentation to be in gtk-doc format, Anthony Liguori, 2011/12/14
[Qemu-devel] [PATCH 1/4] memory: make memory API parsable by gtkdoc-scan, Anthony Liguori, 2011/12/14
Re: [Qemu-devel] [PATCH 1/4] memory: make memory API parsable by gtkdoc-scan, Stefan Weil, 2011/12/14
Re: [Qemu-devel] [PATCH 1/4] memory: make memory API parsable by gtkdoc-scan, Anthony Liguori, 2011/12/14
Re: [Qemu-devel] [PATCH 1/4] memory: make memory API parsable by gtkdoc-scan, Stefan Weil, 2011/12/14
Re: [Qemu-devel] [PATCH 1/4] memory: make memory API parsable by gtkdoc-scan, Anthony Liguori, 2011/12/14