On Thu, Jun 14, 2018 at 10:44:53AM +0200, Mario Six wrote:
The Linux kernel moved to sphinx-based documentation and got rid of the DocBook based documentation quite a while ago. Hence, the DocBook documentation for U-Boot should be converted as well.
To achieve this, import the necessary files from Linux v4.17-r6, and convert the current DocBook documentation (three files altogether) to sphinx/reStructuredText.
For now, all old DocBook documentation was merged into a single handbook, tentatively named "U-Boot Hacker Manual".
For some source files, the documentation style was changed to comply with kernel-doc; no functional changes were applied.
Signed-off-by: Mario Six mario.six@gdsys.cc
I like this idea, thanks for doing it. While I wish more stuff was done for DocBook, and rST isn't my favorite style, it's worth I think strongly considering the switch to as I expect some of my own usage issues to be better by now or be addressed sooner rather than later as more people pick up the tools, find problems, and fix them.