HDFS-5594: make FileSystem JavaDocs describing flags clearer