JavaDoc improvements as suggested by API council.

Bug: b/35813554
Test: Not needed.
Change-Id: I009497bab66c9cc624f434f6d2dde0d80381d961
3 files changed