documentation changes for clarity -- bug #1599041