[U-Boot] [PATCH] WIP: cbfs: Add docbook template

Marek Vasut marex at denx.de
Thu Nov 1 00:39:48 CET 2012


Dear Simon Glass,

> This adds a docbook template for fs, and makes CBFS use it.
> 
> Problems (advise please as I have enough 500pp books in my bookshelf):
> 
> 1. It requires the function names to be repeated. I would like to do this:

Repeating function names is good, you can be sure what the comment is associated 
with.

[...]

> 2. It will not accept the doxygen @param style for parameters:

It's not doxygen, sorry. Read [1].

btw. I'd like some kind of @return, but maybe describing the return value in 
comment is enough.

[...]

[1] http://www.denx.de/wiki/U-Boot/CodingStyle

Best regards,
Marek Vasut


More information about the U-Boot mailing list