This doesn't belong in the docstring, since the property has no reference to dim.  I think it should be a comment.