changes to swarm defaults, introduced some java doc