added more comments and examples
comments and examples, bug fix in v11