enhanced the man page; see also the disclaimer section and  issue #26
Merge remote-tracking branch 'origin/master' into customizingPrompt