The fold-method marker can be used to set folds in Java source. Define a marker and place it inside HTML comments . This way, it does not affect the Javadocs generated without the necessity of a seprate comment line. For example: /** * * The class description. * ... */ public class AbcClass { /** * * Method description. */ public void someMethod(); ... } /* zz.END: AbcClass */ /* Put this at the end of your file */ /* vim:fdm=marker fmr=zz.FOLDSTART,zz.END fdl=2 fdc=2: */ Now the file will be opened with the methods neatly folded, and typing zR will open all folds. fdm=/**,*/