improved usage notes