improve perldocs
preparing for 1.30