[U-Boot] KernelDoc
Marek Vasut
marex at denx.de
Wed Sep 26 21:54:59 CEST 2012
Dear Wolfgang Denk,
> Dear Marek,
>
> In message <201209262110.18172.marex at denx.de> you wrote:
> > > But we need to borrow the Documentation/DocBook
> > > Makefile and logic and so on from the kernel first. And add template
> > > files for the DM sections so something can be spit out.
> >
> > I'd leave that for step 2 (documentation generation) and don't bother
> > with this right away.
>
> If you don't build documentation right from the beginning, you will
> not notice any errors or deficiencies in the comments, and reworking
> later will be way more effort.
I agree with this, but I can not do that right now. I'm flat out too swamped.
> I think if we add it, then it needs to be done Right (TM).
I agree
OT: I would hate to rework the patches that already follow that style and then
rework them again. Maybe we can do a compromise, drop the initial double-
asterisk and otherwise follow the kernel-doc?
> Best regards,
>
> Wolfgang Denk
Best regards,
Marek Vasut
More information about the U-Boot
mailing list