[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