[U-Boot] KernelDoc

Wolfgang Denk
2012-09-26T19:46:55Z

Dear Marek,

In message <201209262110.18172.marex@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 think if we add it, then it needs to be done Right (TM).

Best regards,

Wolfgang Denk

--
DENX Software Engineering GmbH, MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-10 Fax: (+49)-8142-66989-80 Email: wd at denx.de
"Ja, mach' nur einen Plan, sei nur ein grosses Licht
und mach' dann noch 'nen zweiten Plan, geh'n tun sie beide nicht."
-- Bert Brecht, Dreigroschenoper