updated comments and usage examples