In writing some new code I found the docs layout here a bit tedious to work with when writing new code, so made some improvements:
Generic cpp/c api docs into different directories so that you can generate both at once without trampling one or the other.
make with no args in the docs/api directory now builds both by default.
Combine doc-building CI jobs into one job that builds and then uploads both at once.
Move CI-specific upload script into /utils/ci
Remove most Declaration: sections: if no such section is found, we now scrape the source code for the code immediately following the comment and use that. Declaration: is now only used where that isn't the same, or where it has multiple declarations in one.
Remove most of the C++ Declaration:s (the C ones seem different enough from the actual code items).
Make Outputs: optional and remove all the superflous void output descriptions.
adds config/*/*.hpp to the doc generator makefile to catch the new WIP group config (which will go under session/config/groups/)
In writing some new code I found the docs layout here a bit tedious to work with when writing new code, so made some improvements:
make
with no args in the docs/api directory now builds both by default./utils/ci
Declaration:
sections: if no such section is found, we now scrape the source code for the code immediately following the comment and use that. Declaration: is now only used where that isn't the same, or where it has multiple declarations in one.Outputs:
optional and remove all the superflousvoid
output descriptions.config/*/*.hpp
to the doc generator makefile to catch the new WIP group config (which will go under session/config/groups/)