readme updated
examples and exceptions addded