fixes options so that they are extended in the correct order or precendence.
removes duplicate headings from readme. updates examples/tests
0.1.1