add note about throwing NSRangeException and document the return value in @return
document block properties properly
correct minor syntax error in documentation