small changes to documentation and other functions