updated docs for using examples
fix some documentation and touch up some key processing code
vim swap file got into commit