correcting doc inaccuracies and ambiguities.