updated docs and examples with new constructors.