cleaning up lots of documentation to clip to 80 characters wide to conform to the conventions