upload-artifact@v4 is not supported on self-hosted Gitea (GHES).
Downgrade to v3 which works with Gitea Actions.
GITHUB_SERVER_URL resolves to the internal Docker address (http://gitea:3000)
instead of the public URL, making the gh-pages push URL malformed.
Hardcode gitea.archvium.eu as the push target.
CMakeLists.txt: generate firmware.map via -Wl,-Map.
CI build job:
- Writes per-section size table to the Gitea job summary
(visible in the Actions UI after each run).
- Uploads firmware.hex and firmware.map as a downloadable artifact
named firmware-<sha>.
CI docs job:
- On push to main, force-pushes docs/html/ as an orphan commit to
the gh-pages branch. Gitea Pages must be enabled in site admin
for the HTML to be served; the branch is always available via the
repo file browser regardless.
Volume mounts with -v $PWD:/src fail when the runner itself runs
inside a container (the path exists in the runner container but not
on the Docker daemon host). Switch all four jobs to native apt-get
installs of the same packages that are in the Dockerfile. The
container-based just recipes remain unchanged for local use.
Doxygen:
- Doxyfile: minimal config, HTML output to docs/, no LaTeX
- @file/@brief on all source files, full @param/@return on public API
- docs/ added to .gitignore
clang-format (14, Linux brace style, 4-space, column 100):
- .clang-format added
- Applied to entire codebase; this commit is the canonical baseline
- just format rewrites in-place; just format-check is the CI gate
cppcheck (--enable=warning,style,performance,portability):
- Linker-symbol pointer comparisons in startup.c suppressed with
inline cppcheck-suppress (false positives, not real bugs)
- just lint runs cppcheck; zero warnings required to pass
Dockerfile gains clang-format, cppcheck, doxygen packages so all
tools run inside the existing container -- host stays clean.
Gitea Actions (.gitea/workflows/ci.yml):
- Four parallel jobs: build, format, lint, docs
- All jobs use the same Dockerfile-based image
- Doxygen job fails on any warning line in output
