added required falg, changed documentation examples to use it
Merge pull request #3 from chrischang12/master

added required flag, changed documentation examples to use it