bring docs into line with reality