update doc blocks

I noticed some annotations being out of sync with the code, so I updated those that I could find
array is indeed redundant. I'll try fixing this later today.