-# Hacky makefile to compile everything and run the tests in some kind of sane order.
-# V=--verbose for verbose tests.
+# Hacky makefile to compile everything and run the tests in some kind
+# of sane order.
+
+# Main targets:
+#
+# check: run tests on all ccan modules (use 'make check V=--verbose' for more)
+# Includes building libccan.a.
+# tools: build useful tools in tools/ dir.
+# Especially tools/ccanlint/ccanlint and tools/namespacize.
+# distclean: destroy everything back to pristine state