polyline specs

@aesnyder 
@cthrax 
@gitnik 
@kandizzy 

- see commit comments