some bare bones documentation on functions
removed imperative code
backup commit
cleaned-up code, testing in progress
minor refactoring, backup check-in