update in-line documentation for a couple scripts