document discid.read/put on module level

These should now be used to create DiscID objects,
rather than creating them directly.
fix free() for tests
change examples to module level read()

This also means the DiscId() object is not mentioned in code directly
anymore.
rewrite tests to use read() on module level