[Pkg-libopendbx-maintainers] Bug#759951: Bug#760540: duplicate report

[Helmut Grohne]

On Fri, Sep 05, 2014 at 11:22:42AM +0200, Helmut Grohne wrote:
> I bisected this issue and attach a bisection log. Unfortunately, it
> ended up segfaulting eventually and I marked all segfaults with skip. If
> one pretends that 14f88af12bae98859eafe605ddb5f54029e44076 is not the
> cause for this regression and cherry-picks it throughout the bisection,
> then 0dd59398b3f62288897c8c3405977a27a94fbfee is called out as the
> offending commit. I do not understand why either of these commits would
> introduce the regression though.

Actually, this not not even a bug in Doxygen. It is "just" Doxygen
changing its API in backwards-incompatible ways again. Yay.

So commit 0dd59398b3f62288897c8c3405977a27a94fbfee adds a new
"FileParser" which becomes the new default parser. The former parser was
the C parser. Normally, parsers are selected by file extension, so you
usually don't use the default parser.

In libopendbx however, the default parser is used to parse
lib/opendbx/api (which is extension-less). The new "FileParser" does not
understand the syntax of that file and basically ignores it.

I therefore suggest to rename lib/opendbx/api to lib/opendbx/api.dox and
update value of the "INPUT" item in the Doxyfile accordingly.

Helmut