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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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

_______________________________________________
barebox mailing list
barebox@xxxxxxxxxxxxxxxxxxx
http://lists.infradead.org/mailman/listinfo/barebox





[Index of Archives]     [Linux Embedded]     [Linux USB Devel]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]     [XFree86]

  Powered by Linux