On Thu, Jun 02, 2016 at 04:52:08PM +0300, Jani Nikula wrote:
On Wed, 01 Jun 2016, Daniel Vetter daniel.vetter@ffwll.ch wrote:
We need to get folks to run
$ make htmldocs
more often and actually check the output. With the fancy new sphinx stuff there's hopefully no more excuses.
I think we should make kernel-doc return non-zero exit code if you specify a function or doc section with -function and it's not found. This should be a build stopping error, not a warning.
There's still the trouble that if people don't build the docs, they won't notice ... Which means other people who want to type the docs will constantly stumbled over a broken doc build. Not sure how to fix that, especially since make htmldocs still takes a lot of time and fails way too often when rebuilding after the tree changed :( -Daniel