minimal cleanup of a few documentation warnings