Merge branch 'main' into feature/prepare-cmake-workflow-presets

Author: ClausKlein

.github/workflows/doxygen-gh-pages.yml

@@ -0,0 +1,19 @@
+name: Doxygen GitHub Pages Deploy Action
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: DenverCoder1/[email protected]
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          branch: gh-pages
+          folder: docs/html
+          config_file: docs/Doxyfile

.gitignore

@@ -32,8 +32,6 @@
 *.app
 
 build
-mkerr
-olderr
 .DS_store
 .vs
 .vscode
@@ -42,3 +40,6 @@ stagedir
 # In-source builds are not allowed
 CMakeCache.txt
 CMakeFiles/
+
+docs/html
+docs/latex

Makefile

@@ -2,7 +2,8 @@
 # SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 
 SANITIZERS = release debug msan asan usan tsan
-.PHONY: default run update check ce todo distclean clean codespell build test all $(SANITIZERS)
+
+.PHONY: default doc run update check ce todo distclean clean codespell build test all format $(SANITIZERS)
 
 COMPILER=system
 CXX_BASE=$(CXX:$(dir $(CXX))%=%)
@@ -51,6 +52,9 @@ all: $(SANITIZERS)
 run: test
 	./$(BUILD)/examples/$(EXAMPLE)
 
+doc:
+	doxygen docs/Doxyfile
+
 release: test
 
 $(SANITIZERS):
@@ -79,9 +83,13 @@ check:
 		< $$h sed -n "/^ *# *include <Beman\//s@.*[</]Beman/\(.*\).hpp>.*@$$from \1@p"; \
 	done | tsort > /dev/null
 
+
 codespell:
 	codespell -L statics,snd,copyable,cancelled
 
+format:
+	clang-format -i `git diff --name-only main | egrep '\.[ch]pp'`
+
 todo:
 	bin/mk-todo.py
 

assets/css/style.scss

@@ -0,0 +1,4 @@
+---
+---
+
+@import "{{ site.theme }}";