updating files with @bobsilverberg comments.