updated with 2.3 usage notes