Closed xypron closed 6 years ago
I'm guessing you meant to report this against https://github.com/sphinx-doc/sphinx, which is where the core functionality for sphinx-apidoc lives. This is only an extension for that. However, I would suggest contacting the U-Boot developers directly as they have set this up and likely understand how it works better than anyone.
The problem was in a script built around sphinx. See: https://lkml.org/lkml/2018/9/3/1185
I am using Sphinx to create HTML documentation for project U-Boot (http://git.denx.de/u-boot.git). The documentation is created via
The documentation for some functions is rendered incorrectly.
File lib/efi_loader/efi_boottime.c has the following:
This produces a warning:
The parameter notfiy_function is rendered as:
Why is the warning thrown? Why is the parameter description missing? Why do I get the superfluous ``?
Best regards
Heinrich Schuchardt