FILES=$(wildcard src/*.rs)
+DOCFILES=$(addsuffix .html,$(addprefix docs/,$(notdir $(basename $(FILES)))))
+WORKSPACEFILES=$(addprefix workspace/,$(FILES))
-all: docs rawsrc
-.PHONY: docs rawsrc
+all: docs workspace crates
+.PHONY: docs workspace crates
-docs:
- @docco $(FILES) -l linear
+## Documentation
+docs: $(DOCFILES)
-rawsrc:
- @mkdir -p rawsrc
- @for file in $(FILES); do echo "$$file -> raw$$file"; egrep -v "^[[:space:]]*// " "$$file" > "raw""$$file"; done
+.tmp/docs/%.rs: src/%.rs Makefile
+ @mkdir -p .tmp/docs
+ @echo "$< -> $@"
+ @# sed-fu: remove the "@" from "//@", and remove trailing "/*@*/".
+ @sed 's|^\(\s*//\)@|\1|;s|\s*/\*@\*/$$||' $< > $@
+
+docs/%.html: .tmp/docs/%.rs
+ @./pycco-rs $<
+
+## 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 "$< -> $@"
+ @# 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: $(WORKSPACEFILES)
+ @cargo build
+ @cd workspace && cargo build
+ @cd solutions && cargo build && cargo test