Permit ~ in output path
Bring docs up to speed