Enable CI gate: fix Doxygen and add workflow.

Clear doc-block warnings so doxygen exits 0, add GitHub Actions
for host tests, Doxygen, and manual sync, and document CI in the manual.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-07-06 23:41:30 +02:00
co-authored by Cursor
parent 8cd962ee25
commit 9f76ab9e74
12 changed files with 143 additions and 39 deletions
+14
View File
@@ -62,6 +62,20 @@ doxygen Doxyfile
python3 tools/check-manual-sync.py
\end{drcode}
\section{Continuous integration}
Every push and pull request to \texttt{main} runs
\texttt{.github/workflows/ci.yml} at the repository root (three parallel
jobs, all from the \texttt{Software/} directory):
\begin{enumerate}
\item \textbf{Host tests} --- \texttt{cmake} + \texttt{ctest} on
\texttt{components/core/test} (C++23, \texttt{g++-14} on Ubuntu).
\item \textbf{Doxygen} --- must exit 0 with an empty
\texttt{docs/api/doxygen-warnings.log}.
\item \textbf{Manual sync} --- \texttt{tools/check-manual-sync.py}.
\end{enumerate}
To rebuild the PDF manual (requires a LaTeX installation):
\begin{drcode}[Manual PDF]