[Buildroot] [PATCH 0 of 5 v4 for 2014.08] manual-text generation improvements
thomas.petazzoni at free-electrons.com
Sat Aug 16 07:35:47 UTC 2014
Dear Thomas De Schampheleire,
On Fri, 15 Aug 2014 15:40:33 +0200, Thomas De Schampheleire wrote:
> Thomas De Schampheleire (5)
> Makefile: unconditionally include pkg-utils.mk
> gendoc infra: use $(pkgname) instead of explicitly passing 'manual'
> gendoc infra: add support for asciidoc configuration files
> manual-text: make sure URLs are displayed if a link text was provided
> manual-text: hide image representations
Nice, you've added the list of patches to the cover letter :-)
I've applied the patch series, thanks to you, and to Yann and Samuel
Related to this patch series, here are a few things I noted:
* When building the PDF and txt versions of the manual, I get one
a2x: WARNING: --destination-dir option is only applicable to HTML based outputs
It seems to be harmless as the result is really located in the right
place (output/docs), but I found it worth mentioning.
* Also, here the PDF version of the manual doesn't build:
a2x: ERROR: "dblatex" -t pdf -p "/etc/asciidoc/dblatex/asciidoc-dblatex.xsl" -s "/etc/asciidoc/dblatex/asciidoc-dblatex.sty" -P latex.output.revhistory=0 "/home/thomas/projets/buildroot/output/docs/manual/manual.xml" returned non-zero exit status 1
It's most likely due to something missing or a wrong version in my
installation, but it also means we're maybe not checking for all the
necessary tools before generating the manual.
Both of those 'issues' are not introduced by your patch series, they
existed before it.
Thomas Petazzoni, CTO, Free Electrons
Embedded Linux, Kernel and Android engineering
More information about the buildroot