make hierarchy that can be documented

gen/Makefile

@@ -8,7 +8,7 @@ PYTHON_ARTIFACTS += ./pEpACIDgen/__pycache__
 PYTHON_ARTIFACTS += ./tests/__pycache__
 
 
-.PHONY: all build dist dist-egg dist-whl install install-user install-test venv envtest test develop clean clean-all
+.PHONY: all build dist dist-egg dist-whl install install-user install-test venv envtest test develop examples clean clean-all
 
 all: install
 
@@ -56,7 +56,6 @@ venv:
 install-test:
 	pip3 install .[test]
 
-# TODO: maybe use setup.py test?
 test:
 	pytest
 
@@ -65,15 +64,19 @@ develop:
 	pip install -e .
 
 
+# Examples
+# ========
+# Use these targets only in venv created with 'make venv'
+examples:
+	$(MAKE) -C examples/ all
+
 # Housekeeping
 # ============
 clean-all: clean
 	rm -rf $(VENV_DIR)
 
 clean:
-	make -C examples/lib/lib_synth_shed/ clean
+	make -C examples/ clean
-	make -C examples/lib/lib_test/ clean
-	make -C examples/ext/synth_shed/ clean
 	rm -rf $(BUILD_DIR)
 	rm -rf $(DIST_DIR)
 	rm -rf $(PYTHON_ARTIFACTS)

gen/examples/Makefile

@@ -0,0 +1,11 @@
+.PHONY: all
+
+all:
+	$(MAKE) -C lib/lib_test/
+	$(MAKE) -C lib/lib_synth_shed/
+	$(MAKE) -C ext/synth_shed/
+
+clean:
+	$(MAKE) -C lib/lib_test/ clean
+	$(MAKE) -C lib/lib_synth_shed/ clean
+	$(MAKE) -C ext/synth_shed/ clean