Moved example files into a subdirectory.
Improved error messages.
Rewrote docs to use example/* files.