readme & invocation rewrites.