Add information about the DOM shims to the README.

I updated other API documentation to show what parameters
they take as well.

Fixes #224.