more usage examples
fixed documentation