All new code should be using rst docstrings instead of epydocs, especially for something like this where we'll want to generate them and give to extension writers. I won't point out each one, but check the rest of the file for both the @ symbols and the I{} syntax which is also invalid in rst.