Doxygen version 1.8.16 introduced an issue which breaks the compilation
of sigrok's C++ binding (https://github.com/doxygen/doxygen/issues/7190).
Don't set the FILE_PATTERNS variable at all, instead of assigning an
empty value. This resolves bug #1422.
Explicitly use SRCDIR and BUILDDIR in Doxyfile files to reference input
files. This seems to be a sufficient fix for an issue where the build
would fail when libsigrok/ was located in a directory that was a symlink.
This fixes bug #547.
This is more specific and prevents any potential issues e.g. when
multiple distro packages might ship with a generic file like
sigrok-logo-notext.png that's supposed to be installed in the same place.
Current exclude patterns lead to unwanted exclusion of all paths
containing common directory names like output, bindings etc. even
if those names occur higher in the directory structure.
Make exclude patterns more specific by prefixing them with src/.
Signed-off-by: Bartosz Golaszewski <bgolaszewski@baylibre.com>
This also makes the diff from Doxyfile to Doxyfile_internal more readable.
Also, put public API docs into doxy/html-api/, private stuff into
doxy/html-internal/.
- Show a short project description, the libsigrok version (x.y.z or
"unreleased development snapshot"), and the sigrok logo in the
Doxygen output.
- Ignore a bunch of files and directories which don't contain public
libsigrok API anyway.
- Remove the SR_API prefix from the Doxygen output (all
functions/symbols in the output are part of the public API anyway).
- Various changes of settings to get nicer and more useful output.
Uwe Hermann
Gerhard Sittig
Lars-Peter Clausen
Bartosz Golaszewski
Marcus Comstedt
Martin Ling
Bert Vermeulen
Matthias Heidbrink