Hi Jerome,
On Tue, 29 Apr 2025 at 04:16, Jerome Forissier
<jerome.foriss...@linaro.org> wrote:
>
> Hi Tom,
>
> On 4/28/25 23:40, Tom Rini wrote:
> > Hey,
> >
> > As part of manually building the docs before doing -rc1, I saw the
> > following:
> > ./include/uthread.h:56: warning: cannot understand function prototype:
> > 'enum uthread_mutex_state '
> > ./include/uthread.h:64: warning: cannot understand function prototype:
> > 'struct uthread_mutex '
> > ./include/uthread.h:56: warning: cannot understand function prototype:
> > 'enum uthread_mutex_state '
> > ./include/uthread.h:64: warning: cannot understand function prototype:
> > 'struct uthread_mutex '
> >
> > Which should be fixed.
>
> Please see https://lists.denx.de/pipermail/u-boot/2025-April/588263.html.
>
> > I also noticed that with KDOC_WERROR=1 this did
> > not fail and still produced an exit status of 0 which is why it was
> > merged and not noticed until now.
>
> That's unfortunate. I don't understand why warning don't stop the build
> given that sphinx-build is given the -W option already.
This is what I see from make htmldocs:
>>>
HOSTCC scripts/basic/fixdep
SPHINX htmldocs -->
file:///scratch/sglass/cosarm/src/third_party/u-boot/files/doc/output
PARSE include/linker_lists.h
Running Sphinx v8.1.3
enabling CJK for LaTeX builder
loading translations [en]... done
Converting `source_suffix = '.rst'` to `source_suffix = {'.rst':
'restructuredtext'}`.
building [mo]: targets for 0 po files that are out of date
writing output...
building [html]: targets for 661 source files that are out of date
updating environment: [new config] 661 added, 0 changed, 0 removed
reading sources... [100%] usage/semihosting .. usage/upl
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
copying assets...
copying downloadable files... [100%]
device-tree-bindings/firmware/fwu-mdata-gpt.yaml
copying static files...
Writing evaluated template result to
/scratch/sglass/cosarm/src/third_party/u-boot/files/doc/output/_static/language_data.js
Writing evaluated template result to
/scratch/sglass/cosarm/src/third_party/u-boot/files/doc/output/_static/basic.css
Writing evaluated template result to
/scratch/sglass/cosarm/src/third_party/u-boot/files/doc/output/_static/documentation_options.js
Writing evaluated template result to
/scratch/sglass/cosarm/src/third_party/u-boot/files/doc/output/_static/js/versions.js
copying static files: done
copying extra files...
copying extra files: done
copying assets: done
writing output... [100%] usage/spl_boot .. usage/upl *
generating indices... genindex done
writing additional pages... search done
copying images... [100%] develop/pics/flamegraph_timing.png
dumping search index in English (code: en)... done
dumping object inventory... done
build succeeded.
The HTML pages are in doc/output. *
<<<
I would suggest that only the lines marked * have any value. Then we
might notice the warnings.
Regards,
Simon
