Re: [U-Boot] kernel-doc vs Doxygen

On Wed, Aug 14, 2019 at 09:16:40PM +0300, Sam Protsenko wrote:

Hi everyone,

Quick question: which comment style is allowed in U-Boot, kernel-doc or Doxygen one? I have noticed that both are used currently (and I've sent some patches with doxy comments myself). Please tell me if somebody is actually running either kernel-doc or Doxygen to generate the U-Boot documentation. If one particular style is preferred, maybe it's worth to mention it somewhere in doc/ or in README.

We're (slowly) moving towards once again following the kernel now that there's real consistent effort on that front that we can make use of, thanks!