dropped local variable.  improved documentation.
example-snapshot taken from within emacs