Generate docs for apps

make/apps.mk

@@ -12,4 +12,10 @@ clean_apps:
 format_apps:
 	@for d in $(apps); do make -C $$d platform=$(platform) format; done
 
-.PHONY: all_apps clean_apps format_apps
+docs_apps:
+	@for d in $(apps); do make -C $$d platform=$(platform) docs; done
+
+compiledb_apps:
+	@for d in $(apps); do make -C $$d platform=$(platform) compiledb; done
+
+.PHONY: all_apps clean_apps format_apps docs_apps compiledb_apps

make/user.mk

@@ -13,6 +13,18 @@ include ../$(platform)/flags.mk
 
 FORMAT ?= clang-format -i $$(git ls-files '*.c' '*.h')
 
+DOCS_COLLECT ?= $$(git ls-files '*.c' '*.h')
+
+DOCS ?= \
+	rm -rf docs; \
+	clang-doc --format=md --output docs -p . $(DOCS_COLLECT); \
+	for f in ./docs/GlobalNamespace/*.md; \
+		do sed -i '/^\# Global Namespace/d' "$$f"; \
+	done; \
+	rm -rf ../docs/apps/$(app); \
+	mkdir -p ../docs/apps/$(app); \
+	cp ./docs/GlobalNamespace/*.md ../docs/apps/$(app);
+
 all: $(app)
 
 $(app): $(extra_deps) $(o)
@@ -30,4 +42,10 @@ clean:
 format:
 	$(FORMAT)
 
-.PHONY: all clean format
+docs:
+	$(DOCS)
+
+compiledb:
+	bear --output compile_commands.json -- make platform=$(platform) all
+
+.PHONY: all clean format docs compiledb