all: docs workspace crates
.PHONY: docs workspace crates
-# Documentation
+## Documentation
docs: $(DOCFILES)
-.tmp/docs/%.rs: src/%.rs Makefile
+.tmp/docs/%.rs: src/%.rs Makefile dup-unimpl.sed
@mkdir -p .tmp/docs
@echo "$< -> $@"
- @sed 's|^\(\s*//\)@|\1|;s|\s*/\*@\*/||' $< > $@
+ @# sed-fu: remove the "@" from "//@", and remove trailing "/*@*/", replace lines ending in "/*@@*/" by "unimplemented!()".
+ @# Also coalesce multiple adjacent such lines to one.
+ @sed 's|^\(\s*//\)@|\1|;s|\s*/\*@\*/$$||;s|\(\s*\)\S.*/\*@@\*/|\1unimplemented!()|' $< | sed -f dup-unimpl.sed > $@
docs/%.html: .tmp/docs/%.rs
@./pycco-rs $<
-# Workspace
+## Workspace
+# The generated files are shipped only for the benefit of Windows users, who
+# typically don't have the necessary tools for generating the workspace
+# available.
workspace: $(WORKSPACEFILES)
workspace/src/%.rs: src/%.rs Makefile dup-unimpl.sed
@mkdir -p .tmp/docs
@echo "$< -> $@"
- @echo "// ***Remember to enable/add this part in \`main.rs\`!***" > $@
- @echo >> $@
- @sed '/^\s*\/\/@/d;s|\(\s*\)[^\s].*/\*@\*/|\1unimplemented!()|' $< | sed -f dup-unimpl.sed >> $@
+ @# sed-fu: remove lines starting with "//@", and replace those ending in "/*@*/" by "unimplemented!()".
+ @# Also coalesce multiple adjacent such lines to one.
+ @sed '/^\s*\/\/@/d;s|\(\s*\)\S.*/\*@@?\*/|\1unimplemented!()|' $< | sed -f dup-unimpl.sed > $@
workspace/src/main.rs:
# Don't touch this file
-# Crates
-crates:
+## Crates
+crates: $(WORKSPACEFILES)
@cargo build
- @cd solutions && cargo build
+ @cd workspace && cargo build
+ @cd solutions && cargo build && cargo test