usage examples; closes #1