tweak docs until ~line 280