Minor improvements to `wp theme path`

Docs and a functional test. Ready for merge.