make Weaver put deprecation sections at the top
clean up Connection.pm docs