document new usage style