improved some doc strings
Merge branch 'master' of https://github.com/JDCockburn/Glasgow
added another useful message