从源码生成 Zephyr 文档

从源码生成 Zephyr 文档

生成的过程大约需要10分钟。pdf 格式的文档生成失败，html 格式的文档生成成功。

https://blog.csdn.net/zoomdy/article/details/90022599
mingdu.zheng at gmail dot com

安装文档生成工具

sudo apt install doxygen latexmk librsvg2-bin

生成 pdf 文档

cd zephyr-zephyr-v1.14.0
make pdfdocs

生成 pdf 文档失败，错误信息如下：

[4/5] Generating PDF documentation
FAILED: cd /home/user/opt/zephyr/zephyr-zephyr-v1.14.0/doc/_build/latex && /home/user/.local/lib/python3.5/site-packages/cmake/data/bin/cmake -E env LATEXOPTS="-halt-on-error\ -no-shell-escape" /usr/bin/latexmk -quiet -pdf -dvi- -ps-
Latexmk: Run number 1 of rule 'pdflatex'
pdflatex: unrecognized option '-halt-on-error -no-shell-escape'
This is pdfTeX, Version 3.14159265-2.6-1.40.16 (TeX Live 2015/Debian) (preloaded format=pdflatex)
 restricted \write18 enabled.
entering extended mode
Collected error summary (may duplicate other messages):
  pdflatex: Command for 'pdflatex' gave return code 256
Latexmk: Use the -f option to force complete processing,
 unless error was exceeding maximum runs of latex/pdflatex.
ninja: build stopped: subcommand failed.
Makefile:25: recipe for target 'pdfdocs' failed
make: *** [pdfdocs] Error 1

生成 html 文档

make htmldocs

编译好的文件位于 doc/_build/html 目录下。