include USAGE messages in examples
add links
learned this the hard way