[nobug] doc updates to remove JavaDoc warnings and deprecated preference code
5 files changed