usability improvements, checkdoc fixes