documented example usage
closes #1