updated with usage notes