minor updates

updated documentation and global variables