added some javadoc to bring more light on hector configuration for firewalls

just some more javadoc as already discussed/announced on the ML