[JENKINS-5253] Reworking javadoc and adding inline documentation for new option