add verbose switch to readme usage and linkify names