[PATCH libevdev 00/10] doxygen: fix several distribution scenarios
Gaetan Nadon
memsize at videotron.ca
Sun Nov 24 05:02:24 PST 2013
Incorrect behaviours:
---------------------
Every time a target is run in the doc makefile when the html dir is absent,
you get the 'find: `html': No such file or directory' error message.
Every time the make command is invoked, the html dir is built which should not
happen.
Running 'make dist' or 'make distcheck' should trigger the generation of
doxygen and successfully produce a tarball. This should not be a two step
process where you need to build the module and then create the tarball.
When doxygen is not installed, you cannot create a tarball from a tarball,
even if the html docs are included in the host tarball, as they always are.
===========================================================================
The 'dist' target test matrix. Note that 'distcheck' runs 'dist' first.
Doxy; srcdir; git; no-html: tarball created
Doxy; srcdir; tar; html: tarball created
Doxy; srcdir; tar; no-html: tarball created
Doxy; builddir; git; no-html: tarball created
Doxy; builddir; tar; html: tarball created
Doxy; builddir; tar; no-html: tarball created
No-doxy; srcdir; git; no-html: Refusing dist Msg
No-doxy; srcdir; tar; html: tarball created
No-doxy; builddir; git; no-html: Refusing dist Msg
No-doxy; builddir; tar; html: tarball created
Doxy: doxygen tool is installed to generate html from header files
srcdir: the html docs are generated in the same directory as the source
builldir: the html docs are generated in a deparate build directory
git vs tar: build is done from git cloned module or from a tarball (with html)
no-html: the html files in the tarball have been deleted (make clean)
Gaetan Nadon (10):
doxygen: libevdev.doxygen must not be distributed
doxygen: invocation of doxygen fails due to hard coded path
doxygen: implement silent rules in the makefile
doxygen: remove redundant "dist_noinst_DATA = libevdev.doxygen.in" statement
doxygen: fix error msg: 'find: `html': No such file or directory'
doxygen: fix rebuild when not necessary
doxygen: fix 'make dist' from tarball when doxygen is missing
doxygen: fix 'distcheck' for tarballs srcdir!=builddir without doxygen
doxygen: fix 'dist' when the html docs have not yet been built
doxygen: move dist-hook to "doxygen not installed" section
doc/Makefile.am | 32 +++++++++++++++++++++-----------
1 file changed, 21 insertions(+), 11 deletions(-)
--
1.7.9.5
More information about the Input-tools
mailing list