more marking things for deprecation
remove mnemonic use & description from the readme
add api compat message to master branch;  these changes are due to come in within the week
add rest of the README update
Merge branch 'master' into breaking-api-cleanup

Conflicts:
	named.go
	sqlx.go