kumquat-buildroot/docs
Samuel Martin e9f44f0abb gendoc infra: disable pdf manual generation if xsltproc is buggy
The PDF manual generation reaches the default xsltproc's template
recursion limit when processing the target package list; this makes the
PDF manual generation fail [1-3].

This limit can be raised with the '--maxvars' option. Unfortunately,
this option is not correctly handled in the latest xsltproc/libxslt
release (1.1.28), but this bug is already fixed in the libxslt
repository [4].

This patch disables the PDF manual generation (makes it warn with a
meaningful error message) when the xsltproc program found in the PATH
does not support the --maxvars option.
So, one can still generate the PDF manual if he/she extends PATH with
the location of a working xsltproc, by running:

  $ PATH=/path/to/custom-xsltproc/bin:${PATH} make manual-pdf

[1] http://lists.busybox.net/pipermail/buildroot/2014-August/104390.html
[2] http://lists.busybox.net/pipermail/buildroot/2014-August/104418.html
[3] http://lists.busybox.net/pipermail/buildroot/2014-August/104421.html
[4] 5af7ad7453

Reported-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Cc: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Samuel Martin <s.martin49@gmail.com>
[yann.morin.1998@free.fr: move the assignment block out of GENDOC_INNER, no
 need to retest for each type of each document: it's always the same answer;
 make it a warning as per Thomas DS. suggestion]
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
2014-10-12 07:46:26 +02:00
..
css docs: improve look of sponsors page 2014-09-21 21:20:54 +02:00
images docs: improve look of sponsors page 2014-09-21 21:20:54 +02:00
js website: remove remaining references to uclibc.org 2014-05-25 21:46:51 +02:00
manual gendoc infra: disable pdf manual generation if xsltproc is buggy 2014-10-12 07:46:26 +02:00
about.html website: new website ! 2014-03-03 21:40:50 +01:00
contribute.html website: rework Contribute page to avoid duplication with manual 2014-05-25 21:45:02 +02:00
copyright.txt trivial: update buildroot e-mail address to buildroot@buildroot.org 2014-02-12 20:39:15 +01:00
docs.html website: remove remaining references to uclibc.org 2014-05-25 21:46:51 +02:00
download.html Update for 2014.08 2014-09-01 13:20:56 +02:00
favicon.ico docs: add favicon / robots.txt 2011-04-04 22:21:47 +02:00
footer.html website: new website ! 2014-03-03 21:40:50 +01:00
git.html website: new website ! 2014-03-03 21:40:50 +01:00
header.html docs: move Buildroot CSS code into its own file 2014-09-21 21:20:02 +02:00
index.html website: add alt-tags to images 2014-05-25 21:51:57 +02:00
news.html docs/news.html: add 2014.08 announcement link 2014-09-01 15:04:48 +02:00
robots.txt docs: add favicon / robots.txt 2011-04-04 22:21:47 +02:00
sponsors.html docs: improve look of sponsors page 2014-09-21 21:20:54 +02:00
support.html website: fix typos and HTML on support page 2014-05-25 21:48:01 +02:00