add a note to the README about this being a tutorial for an ancient version of Rust

[rust-101.git] / Makefile

diff --git a/Makefile b/Makefile
index 25a2fe0e6ee3c6f63257983b77750f6e54ce22b7..d8c0e443d6c5101db95df06a6d49046864d8daf0 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -5,31 +5,41 @@ WORKSPACEFILES=$(addprefix workspace/,$(FILES))
 all: docs workspace crates
 .PHONY: docs workspace crates
 
 all: docs workspace crates
 .PHONY: docs workspace crates
 

-# Documentation
+## Documentation

 docs: $(DOCFILES)
 
 docs: $(DOCFILES)
 

-.tmp/docs/%.rs: src/%.rs Makefile
+.tmp/docs/%.rs: src/%.rs Makefile pycco-rs dup-unimpl.sed

        @mkdir -p .tmp/docs
        @echo "$< -> $@"
        @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
 
 docs/%.html: .tmp/docs/%.rs

-       @./pycco-rs $<
+       ~/.local/pipx/venvs/pycco/bin/python pycco-rs $<

 
 

-# Workspace
-workspace: $(WORKSPACEFILES)
+## 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) docs/workspace.zip

 
 workspace/src/%.rs: src/%.rs Makefile dup-unimpl.sed
 
 workspace/src/%.rs: src/%.rs Makefile dup-unimpl.sed

-       @mkdir -p .tmp/docs
+       @mkdir -p .tmp/docs workspace/src/

        @echo "$< -> $@"
        @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 "/*@*/" or "/*@@*/" 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
 
 
 workspace/src/main.rs:
        # Don't touch this file
 

-# Crates
-crates:
+docs/workspace.zip: $(WORKSPACEFILES) workspace/Cargo.toml workspace/Cargo.lock
+       @rm -f $@
+       zip $@ $^
+
+## Crates
+crates: $(WORKSPACEFILES)

        @cargo build
        @cargo build

-       @cd solutions && cargo build
+       @cd workspace && cargo build
+       @cd solutions && cargo build && cargo test