Adjust compile task to make use of regex fns

Also update documentation.
Remove tests-in-src; tidy up compilation-specs.