minor changes to documentation and variables