small javadocs updates in the regulators-package