[U-Boot] "make htmldocs" gives error

[Masahiro Yamada]

Hello Abraham,


On Tue, 3 Dec 2013 14:25:44 +0530
"Abraham V." <abraham.varricatt at vvdntech.com> wrote:

> Hello everyone,
> (cc Simon Glass)
> 
> I just tried to make the documentation for uboot with the following
> command (checked out latest mainline sources);
> 
> [snip]
> We can see that there's some issue with parsing the comments in the
> linker_lists.h header file.

I posted patches to fix this issue.

> I can understand general developer reluctance at updating
> documentation (I'm lazy about it too), but do we have any way to
> generate some kind of documentation for u-boot? Even Linux-style man
> pages will do.

You may get disappointed because there are only two documents
under doc/Docbook/.
Anyway, we can do "make pdfdocs" if my patches are applied.

> Or is my only recourse to just refer all the doc/README.* files one at a time?

I think
 - doc/README.*
 - web page (http://www.denx.de/wiki/U-Boot/Documentation)
are more recommended.



Best Regards
Masahiro Yamada