Changed API to queryset_decorator, which updates a single item.

This was the variation of queryset_transform I had to use somewhere.
Also updated the demo and documentation accordingly.
Added inline APIDOX
updated README, fixed typos and simplified example
Replace README.txt with README.rst for GitHub parsing

And fixed assorted typoo's
Merge pull request #1 from vdboor/master

latest from upstream