add atPoints, deprecate decorateFoo

Follow up to discussion on diagrams-doc issue # 57.
Deprecate `decorateTrail`, `decorateLocatedTrail`, `decoreatePath`.
Add `atPoints` a curried, flipped version of `position` convenient to
use infix.

Should be ready to merge.