usage notes and examples