[U-Boot] KernelDoc

Wolfgang Denk wd at denx.de
Wed Sep 26 21:46:55 CEST 2012


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 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


More information about the U-Boot mailing list