从源码生成 Zephyr 文档
生成的过程大约需要10分钟。pdf 格式的文档生成失败，html 格式的文档生成成功。
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 目录下。
