add working `reverse`; revise some older comments