polyline specs

- see commit comments