gattlib
gattlib copied to clipboard
Docs are missing most content
With a current clone of gattlib (last check-in Wed Jun 9 17:41:20 2021 +0200) on a Raspberry Pi 4 running the 64 bit Raspberry Pi OS, the documentation build is not complete.
There are no errors showing in the build output. The build was done as listed in the readme, being:
mkdir build && cd build
cmake ..
make
The one change I did make was to set GENERATE_HTML = YES
in docs/Doxyfile.in
.
Looking at gattlib.h
, I would expect to see documentation entries for essentially everything in the file, given how extensive the comments are.
What I'm seeing is a blank main page, four typedefs listed in "Classes List", and 9 items listed in Class Members -> All (and the same ones in Variables). None of the functions listed in gattlib.h
are appearing in the documentation. However, when I look at index.xml
in /build/docs/docs/gattlib/doxygen/xml
, I see all the expected defines and functions, etc. Perhaps I am not turning on HTML docs generation correctly?
Here are two screenshots as well.
If anyone has a suggestion as to what might be wrong here, I'd appreciate hearing it.
Thanks!