\annotate: improve description and examples