[PATCH v1] cmd/dma: documentation

[Sune Brian]

Tom Rini <trini at konsulko.com> 於 2025年10月9日 週四 上午3:46寫道：

> > > > > still) in the shell commands section. Also please do "make htmldocs
> > > > > KDOC_WERROR=1" and make sure there's no complains for v2, I see some

without adding any rst

make htmldocs KDOC_WERROR=1
  HOSTCC  scripts/basic/fixdep
  SPHINX  htmldocs --> file:///media/sf_shared/u-boot/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 694 source files that are out of date
updating environment: [new config] 694 added, 0 changed, 0 removed
reading sources... [100%] usage/fit/kernel_fdt .. usage/upl
looking for now-outdated files... none found
pickling environment... done
checking consistency...
/media/sf_shared/u-boot/doc/develop/package/bintools.rst: WARNING:
document isn't included in any toctree
/media/sf_shared/u-boot/doc/develop/package/entries.rst: WARNING:
document isn't included in any toctree
done
preparing documents... done
copying assets...
copying downloadable files... [100%] ../Licenses/README
copying static files...
Writing evaluated template result to
/media/sf_shared/u-boot/doc/output/_static/basic.css
Writing evaluated template result to
/media/sf_shared/u-boot/doc/output/_static/language_data.js
Writing evaluated template result to
/media/sf_shared/u-boot/doc/output/_static/documentation_options.js
Writing evaluated template result to
/media/sf_shared/u-boot/doc/output/_static/js/versions.js
copying static files: done
copying extra files...
copying extra files: done
copying assets: done
/media/sf_shared/u-boot/doc/build/index.rst:6: WARNING: toctree
contains reference to document 'build/buildman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/package/index.rst:16: WARNING:
toctree contains reference to document 'develop/package/binman' that
doesn't have a title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/package/index.rst:16: WARNING:
toctree contains reference to document 'develop/package/binman' that
doesn't have a title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/build/index.rst:6: WARNING: toctree
contains reference to document 'build/buildman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/build/index.rst:6: WARNING: toctree
contains reference to document 'build/buildman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/build/index.rst:6: WARNING: toctree
contains reference to document 'build/buildman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/build/index.rst:6: WARNING: toctree
contains reference to document 'build/buildman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/build/index.rst:6: WARNING: toctree
contains reference to document 'build/buildman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/build/index.rst:6: WARNING: toctree
contains reference to document 'build/buildman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/build/index.rst:6: WARNING: toctree
contains reference to document 'build/buildman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/build/index.rst:6: WARNING: toctree
contains reference to document 'build/buildman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/build/index.rst:6: WARNING: toctree
contains reference to document 'build/buildman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/build/index.rst:6: WARNING: toctree
contains reference to document 'build/buildman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/uefi/uefi.rst:379: WARNING:
undefined label: 'etype_efi_capsule' [ref.ref]
/media/sf_shared/u-boot/doc/build/index.rst:6: WARNING: toctree
contains reference to document 'build/buildman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/package/index.rst:16: WARNING:
toctree contains reference to document 'develop/package/binman' that
doesn't have a title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/package/index.rst:16: WARNING:
toctree contains reference to document 'develop/package/binman' that
doesn't have a title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/package/index.rst:16: WARNING:
toctree contains reference to document 'develop/package/binman' that
doesn't have a title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
/media/sf_shared/u-boot/doc/develop/index.rst:9: WARNING: toctree
contains reference to document 'develop/patman' that doesn't have a
title: no link will be generated [toc.no_title]
writing output... [100%] usage/fit/x86-fit-boot .. usage/upl
generating indices... genindex py-modindex done
Creating redirect 'develop/py_testing.html' to 'pytest/usage.html'.
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 finished with problems, 125 warnings (with warnings treated as errors).
doc/Makefile:70: recipe for target 'htmldocs' failed
make[1]: *** [htmldocs] Error 1
Makefile:2687: recipe for target 'htmldocs' failed
make: *** [htmldocs] Error 2