documentation updates to reflect upstream fixes