[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation
From: |
Eduardo Habkost |
Subject: |
Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation |
Date: |
Fri, 24 May 2019 16:08:50 -0300 |
User-agent: |
Mutt/1.10.1 (2018-07-13) |
On Fri, May 24, 2019 at 08:34:23PM +0200, Paolo Bonzini wrote:
> On 23/05/19 14:20, John Snow wrote:
> > OK, if that's where we're at! I just saw the RFC from Peter Maydell and
> > assumed we were a little further along the decision making process, but
> > maybe not. I'll stay tuned.
>
> For the decision making, yes; I think there's consensus to use
> kerneldoc. For the "debugging and seeing if anything has changed in 2.5
> years", no.
>
> Testing the patch that Eduardo posted will help Gabriel, Eduardo and
> everyone else decide whether to patch kerneldoc or rather change the API
> doc comments style. (Personally I am in favor of patching; the
> different coding conventions make using vanilla kerneldoc awkward, and
> there are several thousands of lines of existing doc comments which
> would require a transition.)
I'd prefer to fix our doc comments instead of patching kerneldoc,
whenever possible. We don't even have a consistent doc comment
style in QEMU.
--
Eduardo
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, (continued)
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, Paolo Bonzini, 2019/05/21
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, Markus Armbruster, 2019/05/21
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, Daniel P . Berrangé, 2019/05/21
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, Peter Maydell, 2019/05/21
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, Paolo Bonzini, 2019/05/21
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, John Snow, 2019/05/21
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, Eduardo Habkost, 2019/05/21
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, Paolo Bonzini, 2019/05/22
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, John Snow, 2019/05/23
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, Paolo Bonzini, 2019/05/24
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation,
Eduardo Habkost <=
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, Paolo Bonzini, 2019/05/24
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, Eduardo Habkost, 2019/05/21
- Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, Paolo Bonzini, 2019/05/21
Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation, Peter Maydell, 2019/05/21