bit of documentation and minor fixes