definitive release 1.0 + README