fix up javadoc via IDEA code formatting
reduce visibility of FileType constructors
improve javadoc