HDFS-5594: add JavaDocs.