add examples of usage in running text