Add <!-- BROOKLYN_VERSION -> tags to catalog.xml-s

@aledsage, took onboard comments from https://github.com/brooklyncentral/brooklyn/pull/650 . Have cherry picked changes, and this PR can be applied to master. Also noticed some old URLs that needed updating.