make put signature more userfriendly
update example for new put signature
validate put parameters

We should at least check against common usage errors
add TOCError for put()

This is not actually an IOError, in contrast to read().
put gives errors on incorrect usage/parameters.
Merge branch 'simple_put'

See pull-request #29

Conflicts:
	test_discid.py