Open blueyed opened 6 years ago
I've only briefly looked into this, but wanted to leave it here for discussion / further investigation.
That's the "doc fun" that we have. @FOO@
-tokens in the C source need to be expanded during build so that the expanded values can be picked up by ldoc. I find two such places via grep currently:
mousegrabber.c: *@DOC_cursor_c_COMMON@
root.c: *@DOC_cursor_c_COMMON@
I've tried using
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..
to buildcompile_commands.json
, which can be used by clang-tidy etc.But unfortunately the files are referenced in the
build
dir, apparently sinceconfigure_file
"moves" them there. Therefore it's not really useful as-is when editing the actual source file.Example entry for awesome.c:
Also using the command by itself does not work, apparently since
build/common/atoms-extern.h
might not be generated.I've only briefly looked into this, but wanted to leave it here for discussion / further investigation.