updated sample brooklyn.properties for more clouds
minor javadoc addition and usability tweak
Merge pull request #996 from ahgittin/misc

more useful sample "brooklyn.properties" plus very minor code/javadoc tidies