[#1572] added javadoc explaining conditional formatting