fixing up the source section
Adding configuration options

Reverting some of the names so as not to create backwards
incompatibilities.
Improving the README, removing attributes from being called out