[PATCH 08/19] commands: move CMD_MIPS_CPUINFO to commands/Kconfig

Juergen Borleis jbe at pengutronix.de
Tue May 13 06:09:09 PDT 2014


On Tuesday 13 May 2014 14:43:38 Holger Schurig wrote:
> If it would be to me, I'd in long-term kill the doxygen. Or have the
> doxygen only describe the internal API for barebox programmers.
> Currently it mixes internal API and end-user documention, not so nice.

The historical goal was to keep all the documentation and the corresponding 
code close to each other.

The API documentation of doxygen is mostly useless. But to have the description 
of the intention of the code close to the code was my idea, to make 
programmers also change the documentation when they change the code near by. 
But it doesn't work. Programmers are not interested in writing documentation.

jbe

-- 
Pengutronix e.K.                              | Juergen Borleis             |
Linux Solutions for Science and Industry      | http://www.pengutronix.de/  |



More information about the barebox mailing list