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

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