fixed comment spelling typo
fixed minor truncation warning
fixed a few clang -Wdocumentation warnings, comments only