applying doc corrections from pull #1