add more examples, update comments