Refs #8 - In README, converted examples into doctests. WORK IN PROGRESS.
Rename keep_attrs to assigned for consistency with functools.wraps.

Also fixed docs/doctests.