[U-Boot] KernelDoc

Wolfgang Denk
2012-10-01T08:54:58Z

Dear Marek Vasut,

In message <201209270138.12860.marex@denx.de> you wrote:
>
> > I think is kind of unfair to expect such efforts for some basicly
> > unrelated changes. If I were in such a situation, I'd feel tempted to
> > throw the towel.
>
> Why would you do so ... you change interface, you document it.

Having to document not only my change, but all the rest of the source
file as well may mean I spend way more work on this doc task than on
the actual fix.

And while I may well understand the area I meddled with, I may not
easily understand the rest of the code, so this is twice hard and time
consuming.

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
The language provides a programmer with a set of conceptual tools; if
these are inadequate for the task, they will simply be ignored. For
example, seriously restricting the concept of a pointer simply forces
the programmer to use a vector plus integer arithmetic to implement
structures, pointer, etc. Good design and the absence of errors
cannot be guaranteed by mere language features. - Bjarne Stroustrup,
"The C++ Programming Language"