update doc blocks

I noticed some annotations being out of sync with the code, so I updated those that I could find